diff --git a/MIGRATION_GUIDE_v3_to_v5.md b/MIGRATION_GUIDE_v3_to_v5.md index c1d0a290e..ac2651ee1 100644 --- a/MIGRATION_GUIDE_v3_to_v5.md +++ b/MIGRATION_GUIDE_v3_to_v5.md @@ -31,19 +31,19 @@ OneSignal uses a built-in **alias label** called `external_id` which supports ex Follow one of the following sections based on your previous install method of the OneSignal SDK. ### Unity Package Manager -1. If you have them delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -2. In Unity open **Window > Package Manager** -3. From the **Package Manager** window select **Packages:** in the top left and click on **In Project** +1. If you have them, delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` +2. In Unity, open **Window > Package Manager** +3. From the **Package Manager** window, select **Packages:** in the top left and click on **In Project** 4. Select the OneSignal Unity SDK(s) and press the **Upgrade to 5.x.x** button (make sure to update both Android and iOS packages) 5. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls 6. Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run ### Unity Asset Store 1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -2. In Unity open **Window > Package Manager** -3. From the **Package Manager** window select **Packages:** in the top left and click on **My Assets** +2. In Unity, open **Window > Package Manager** +3. From the **Package Manager** window, select **Packages:** in the top left and click on **My Assets** 4. Select the **OneSignal SDK** from the list and press the **Update** button. -5. Once the update has completed click the **Import** button +5. Once the update has completed, click the **Import** button 6. Navigate to **Window > OneSignal SDK Setup** 7. Click **Run All Steps** 8. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls @@ -52,7 +52,7 @@ Follow one of the following sections based on your previous install method of th ### Unitypackage Distributable 1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` 2. Download the latest release from our [releases page](https://github.com/OneSignal/OneSignal-Unity-SDK/releases) -3. In Unity navigate to **Assets > Import Package > Custom Package...** and select the newly downloaded `*.unitypackage` file +3. In Unity, navigate to **Assets > Import Package > Custom Package...** and select the newly downloaded `*.unitypackage` file 4. Navigate to **Window > OneSignal SDK Setup** 7. Click **Run All Steps** 8. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls @@ -248,12 +248,15 @@ The debug namespace is accessible via `OneSignal.Debug` and provides access to d - We will be introducing JWT in follow up Beta release # Troubleshooting + +If you run into the following errors : + `Assets/OneSignal/Example/OneSignalExampleBehaviou.cs: error CS0246: The type or namespace name '...' could not be found (are you missing a using directive or an assembly reference?)` `Assets/OneSignal/Attribution/OneSignalVSAttribution.cs: error CS0117: 'OneSignal' does not contain a definition for '...'` -- Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` +1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -- Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run +2. Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run If you would like to regenerate the OneSignal assets, remove the OneSignal Unity SDK packages (Android, Core, iOS) from your project and import the OneSignal SDK again. \ No newline at end of file diff --git a/OneSignalExample/Assets/OneSignal/MIGRATION_GUIDE_v3_to_v5.md b/OneSignalExample/Assets/OneSignal/MIGRATION_GUIDE_v3_to_v5.md index c1d0a290e..ac2651ee1 100644 --- a/OneSignalExample/Assets/OneSignal/MIGRATION_GUIDE_v3_to_v5.md +++ b/OneSignalExample/Assets/OneSignal/MIGRATION_GUIDE_v3_to_v5.md @@ -31,19 +31,19 @@ OneSignal uses a built-in **alias label** called `external_id` which supports ex Follow one of the following sections based on your previous install method of the OneSignal SDK. ### Unity Package Manager -1. If you have them delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -2. In Unity open **Window > Package Manager** -3. From the **Package Manager** window select **Packages:** in the top left and click on **In Project** +1. If you have them, delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` +2. In Unity, open **Window > Package Manager** +3. From the **Package Manager** window, select **Packages:** in the top left and click on **In Project** 4. Select the OneSignal Unity SDK(s) and press the **Upgrade to 5.x.x** button (make sure to update both Android and iOS packages) 5. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls 6. Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run ### Unity Asset Store 1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -2. In Unity open **Window > Package Manager** -3. From the **Package Manager** window select **Packages:** in the top left and click on **My Assets** +2. In Unity, open **Window > Package Manager** +3. From the **Package Manager** window, select **Packages:** in the top left and click on **My Assets** 4. Select the **OneSignal SDK** from the list and press the **Update** button. -5. Once the update has completed click the **Import** button +5. Once the update has completed, click the **Import** button 6. Navigate to **Window > OneSignal SDK Setup** 7. Click **Run All Steps** 8. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls @@ -52,7 +52,7 @@ Follow one of the following sections based on your previous install method of th ### Unitypackage Distributable 1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` 2. Download the latest release from our [releases page](https://github.com/OneSignal/OneSignal-Unity-SDK/releases) -3. In Unity navigate to **Assets > Import Package > Custom Package...** and select the newly downloaded `*.unitypackage` file +3. In Unity, navigate to **Assets > Import Package > Custom Package...** and select the newly downloaded `*.unitypackage` file 4. Navigate to **Window > OneSignal SDK Setup** 7. Click **Run All Steps** 8. Follow the [API Reference](#api-reference) guide below to fix any compilation errors with the new namespaces and updated method calls @@ -248,12 +248,15 @@ The debug namespace is accessible via `OneSignal.Debug` and provides access to d - We will be introducing JWT in follow up Beta release # Troubleshooting + +If you run into the following errors : + `Assets/OneSignal/Example/OneSignalExampleBehaviou.cs: error CS0246: The type or namespace name '...' could not be found (are you missing a using directive or an assembly reference?)` `Assets/OneSignal/Attribution/OneSignalVSAttribution.cs: error CS0117: 'OneSignal' does not contain a definition for '...'` -- Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` +1. Delete the directory at `Assets/OneSignal` and the xml file at `Assets/Plugins/Android/OneSignalConfig.plugin/AndroidManifest.xml` -- Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run +2. Check the menu at **Window > OneSignal SDK Setup** to see if there are any remaining steps to run If you would like to regenerate the OneSignal assets, remove the OneSignal Unity SDK packages (Android, Core, iOS) from your project and import the OneSignal SDK again. \ No newline at end of file