How To Migrate Your Existing Apps

When upgrading from one version of the Vuforia SDK release to the next, it's recommended that you follow the practices defined in the migration guide for your SDK version. This article identifies both API and project structure changes to the SDK that you should be aware of when upgrading a project from a prior version of the Vuforia Platform.

Migrating from Vuforia 5 to Vuforia 6 

The Changes in Vuforia 6 article describes new features and APIs that have been introduced to support Windows UWP builds, a new Advanced Camera API, and the VuMark. These changes will not affect the migration of Vuforia projects that use the Java and C++ APIs. 

Be sure to review the migration guides for prior versions of the SDK if migrating from an earlier SDK version to Vuforia 6. You'll may need to migrate to an interim version before applying any migration steps for the current version of the SDK.

For general recommendations on how to upgrade an existing project, review the migration article for the SDK version used to develop the project.

See:
How To Migrate an Android Project​
How To Migrate an iOS Project
How To Migrate a Unity Project

Migrating from Vuforia 4 to Vuforia 5 

The Changes in Vuforia 5 article describes new APIs that have been introduced to support digital eyewear and the ability to call Trackable states introduced with Vuforia 5. These changes will not affect the migration of Vuforia projects that use the Java and C++ APIs. 

There has been a refactoring of the Unity APIs and SDK folder structure that will require modifications to Unity projects that are migrated to Vuforia 5, See:  Migrating Unity Projects to Vuforia 5

Apps developed with the Vuforia 4 Digital Eyewear Beta SDK will need a new license key if they were developed for video see-through eyewear, See: Migrating Digital Eyewear Apps to Vuforia 5

For general recommendations on how to upgrade an existing project, review the migration article for the SDK version used to develop the project.

See:
How To Migrate an Android Project​
How To Migrate an iOS Project
How To Migrate a Unity Project

Migrating from Vuforia 3 to Vuforia 4

The Vuforia 4.0 SDK introduced a few significant changes to the Vuforia API. 

1. All Vuforia 4.0 apps need to implement a unique license key from the Vuforia License Manager.
2. The ImageTracker class has been replaced with the ObjectTracker as a unified Tracker type for both objects and images.
3. The Smart Terrain API utilizes a new command design pattern which relies on a SmartTerrainBuilder class that manages the Reconstructions created by Smart Terrain.
4. A new 'Vuforia' namespace has been introduced for Unity. You need to add the following to the top any C# scripts that reference the Vuforia API.
 
using Vuforia;

See: 
Vuforia 4.0 Migration for tips on how to transition your existing code to Vuforia 4.0.

The SDK migration guides documents necessary changes and recommendations for migrating existing Vuforia projects.