# Upgrading ARDK from 2.5.1 to 3.0

**URL:** <https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652>\
**Category:** I'm Stuck\
**Tags:** ardk-30-beta-1\
**Created:** [June 23, 2023, 10:05am UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652 "2023-06-23T10:05:13Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![Daniel](https://avatars.discourse-cdn.com/v4/letter/d/3ec8ea/32.png) [@Daniel](https://community.nianticspatial.com/u/Daniel)\
**Post date:** [June 23, 2023, 10:05am UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/1 "2023-06-23T10:05:13Z")

</div>

Dear Niantic Team,

we as a company developing on a bigger project which relies on ARDK. The news that ARDK now supports AR Foundation is awesome. However since we are developing this for a while(1+ years) it is needed to update from 2.5.1 to 3.0. But using your “great and detailed” migration guide as you described it in the presentation video is actually very very cheeky, almost a joke to be honest. We would actually welcome if you could write an **actually detailed** migration guide for this update since we are fighting with the migration since a couple of hours and have an incompileable project where no end is in sight.

Looking forward to your detailed migration guide. Thanks 🙂

Greets Danex

---

<div class="post-metadata">

**Author:** ![Gilberto](https://avatars.discourse-cdn.com/v4/letter/g/958977/32.png) [@Gilberto](https://community.nianticspatial.com/u/Gilberto)\
**Post date:** [June 23, 2023, 4:46pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/2 "2023-06-23T16:46:13Z")

</div>

Hey Daniel,  
Just as a reminder, we are on Beta 1 of the ARDK 3.0 and just as the features, the documentation is a work in progress that is prone to change and improve as we get closer to the official release.

Having said that, if you need help migrating I’m going to need specifics. “_this is bad, make it better_” is just not constructive feedback for me and I can’t really help you get unstuck with just that either.

What are you getting stuck in? What information are you trying to find that’s not there? What are the errors that you are getting that you can’t find the solution to?

---

<div class="post-metadata">

**Author:** ![Andrey\_Backulev](https://avatars.discourse-cdn.com/v4/letter/a/b19c9b/32.png) [@Andrey\_Backulev](https://community.nianticspatial.com/u/Andrey_Backulev)\
**Post date:** [June 29, 2023, 12:16pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/3 "2023-06-29T12:16:30Z")

</div>

Hi @Gilberto! I’m just trying test your examples from [niantic-lightship/ardk-samples](https://github.com/niantic-lightship/ardk-samples) and facing with issue → DllNotFoundException: ARDK assembly: type: member:(null)  
Niantic.Lightship.AR.LightshipUnityContext.Initialize (Niantic.Lightship.AR.Loader.LightshipSettings settings, System.Boolean isDeviceLidarSupported, System.Boolean isTest) (at Library/PackageCache/com.nianticlabs.lightship@99ba3966301d/Runtime/AppContext/LightshipUnityContext.cs:95)

Can can you give some advices for safety upgrade from 2.5.2 version? Also I didn’t find where I can set MockEnvironment, like in 2.5.2 version

---

<div class="post-metadata">

**Author:** ![Gilberto](https://avatars.discourse-cdn.com/v4/letter/g/958977/32.png) [@Gilberto](https://community.nianticspatial.com/u/Gilberto)\
**Post date:** [June 29, 2023, 10:36pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/4 "2023-06-29T22:36:24Z")

</div>

@Andrey_Backulev ,  
So lets start with the mock environments as that is the most direct answer:

As of now, ARDK 3.0 does not have Mock environments like 2.5.x. We recommend using the playback functionality to test instead.

On the dll error, can you walk me through how you tried to test the samples and when are you seeing this error? Is it when running a sample, when building to device or when opening the editor?

Finally on upgrading, you can read our guide [here](https://lightship.dev/docs/beta/ardk/migration_guide/) but if you have specific questions let me know.

---

<div class="post-metadata">

**Author:** ![Andrey\_Backulev](https://avatars.discourse-cdn.com/v4/letter/a/b19c9b/32.png) [@Andrey\_Backulev](https://community.nianticspatial.com/u/Andrey_Backulev)\
**Post date:** [June 30, 2023, 12:28am UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/5 "2023-06-30T00:28:31Z")

</div>

Error apearing when I starting sample scene from repo

---

<div class="post-metadata">

**Author:** ![Gilberto](https://avatars.discourse-cdn.com/v4/letter/g/958977/32.png) [@Gilberto](https://community.nianticspatial.com/u/Gilberto)\
**Post date:** [June 30, 2023, 9:04pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/6 "2023-06-30T21:04:37Z")

</div>

@Andrey_Backulev , quick question but have you enabled long paths on your windows machine?  
(Reference : [Maximum Path Length Limitation - Win32 apps | Microsoft Learn](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=registry) )

---

<div class="post-metadata">

**Author:** ![Andrey\_Backulev](https://avatars.discourse-cdn.com/v4/letter/a/b19c9b/32.png) [@Andrey\_Backulev](https://community.nianticspatial.com/u/Andrey_Backulev)\
**Post date:** [July 3, 2023, 12:11am UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/7 "2023-07-03T00:11:57Z")

</div>

Yes, long path enabled.

---

<div class="post-metadata">

**Author:** ![Gilberto](https://avatars.discourse-cdn.com/v4/letter/g/958977/32.png) [@Gilberto](https://community.nianticspatial.com/u/Gilberto)\
**Post date:** [July 5, 2023, 9:07pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/8 "2023-07-05T21:07:45Z")

</div>

hmmm I need some way to reproduce this in order to help you… can you walk me through how you downloaded the samples and are trying to build the samples?

---

<div class="post-metadata">

**Author:** ![Andrey\_Backulev](https://avatars.discourse-cdn.com/v4/letter/a/b19c9b/32.png) [@Andrey\_Backulev](https://community.nianticspatial.com/u/Andrey_Backulev)\
**Post date:** [July 6, 2023, 1:42pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/9 "2023-07-06T13:42:30Z")

</div>

I downloaded samples from git via zip archive. Unzip in empty folder and opened with Unity 2021.3.24f1. Then just entered in PlayMode.

---

<div class="post-metadata">

**Author:** ![Andrey\_Backulev](https://avatars.discourse-cdn.com/v4/letter/a/b19c9b/32.png) [@Andrey\_Backulev](https://community.nianticspatial.com/u/Andrey_Backulev)\
**Post date:** [July 10, 2023, 10:29am UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/10 "2023-07-10T10:29:22Z")

</div>

Hi! Do you have any updates here?

---

<div class="post-metadata">

**Author:** ![Gilberto](https://avatars.discourse-cdn.com/v4/letter/g/958977/32.png) [@Gilberto](https://community.nianticspatial.com/u/Gilberto)\
**Post date:** [September 14, 2023, 9:52pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/11 "2023-09-14T21:52:08Z")

</div>

Hey @Andrey_Backulev ,  
sorry for hte lack of response here, I’m checking in on previous tickets and was wondering since we’ve had a couple of releases since, have you been able to run the samples?

---

<div class="post-metadata">

**Author:** ![Alema\_Husic](https://avatars.discourse-cdn.com/v4/letter/a/48db29/32.png) [@Alema\_Husic](https://community.nianticspatial.com/u/Alema_Husic)\
**Post date:** [June 19, 2024, 1:06pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/12 "2024-06-19T13:06:31Z")

</div>

I also have a lot of errors when trying to upgrade to ARDK 3, I followed your migration guide but I still get tons of errors due to incompatibility with my code that was written for ARDK 2.x. Also when I deleted the ARDK folder for some reason all of my materials disappeared. Is there another more detailed guide for migrating that involves what exact namespaces to use, and what are the equivalents of ARSessionStateChangedEventArgs, PlatformAgnosticInput and others since I’m getting errors on most of my code that worked prefectly before and its really hard to find solutions on the internet.

---

<div class="post-metadata">

**Author:** ![Jesus\_Niantic](https://avatars.discourse-cdn.com/v4/letter/j/b782af/32.png) [@Jesus\_Niantic](https://community.nianticspatial.com/u/Jesus_Niantic)\
**Post date:** [June 20, 2024, 6:21pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/13 "2024-06-20T18:21:06Z")

</div>

Hello @Alema_Husic can you please submit a new topic outlining the parts of ARDK 2 that you’re having trouble converting over to 3 along with any error messages you’re getting as well.

---

<div class="post-metadata">

**Author:** ![Maverick\_Niantic](https://avatars.discourse-cdn.com/v4/letter/m/8edcca/32.png) [@Maverick\_Niantic](https://community.nianticspatial.com/u/Maverick_Niantic)\
**Post date:** [March 5, 2026, 11:44pm UTC](https://community.nianticspatial.com/t/upgrading-ardk-from-2-5-1-to-3-0/3652/14 "2026-03-05T23:44:45Z")

</div>

Age
