51黑料不打烊

In addition to the general SDK installation, iOS also requires the following additional code to start the Assurance session for your app.

1. Navigate to Luma > Luma > SceneDelegate in your Xcode鈥檚 Project navigator.

2. Add the following code to func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

   code language-swift
   // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }

   This code starts an assurance session when the app is in the background and opened using a deep link.

In addition to the general SDK installation, Android also requires the following additional code to start the Assurance session for your app.

1. In Android Studio, in the Android view, navigate to app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication.

2. Add the following code to fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   This code starts an assurance session when the app is in the background and opened using a deep link.

1. Open the project in Xcode.
2. Select Luma in the Project navigator.
3. Select the Luma target.
4. Select the Signing & Capabilities tab.
5. Define a Bundle Identifier.

Ensure you use a unique bundle identifier and replace the com.adobe.luma.tutorial.swiftui bundle identifier, as each bundle identifier needs to be unique. Typically, you use a reverse-DNS format for bundle ID strings, like com.organization.brand.uniqueidentifier. The Finished version of this tutorial, for example, uses com.adobe.luma.tutorial.swiftui.

{modal="regular"}

1. Open the project in Android Studio.
2. Select build.gradle.kts (Module :app) in the navigator.
3. Ensure you use a unique bundle identifier and replace the com.adobe.luma.tutorial.android value for namespace in android
4. Ensure you use the same unique bundle identifier and replace the com.adobe.luma.tutorial.android for applicationId in defaultConfig in android

Typically, you use a reverse-DNS format for bundle ID strings, like com.organization.brand.uniqueidentifier. The Finished version of this tutorial, for example, uses com.adobe.luma.tutorial.android.

{modal="regular"}

1. Go to your project in Xcode.

2. Select Luma in the Project navigator.

3. Select the Luma target.

4. Select the Info tab.

5. To add a base URL, scroll down to URL Types and select the + button.

6. Set Identifier to the bundle identifier of your choice and set a URL Schemes of your choice .

   {modal="regular"}

Ensure you use a unique bundle identifier and replace the com.adobe.luma.tutorial.swiftui bundle identifier, as each bundle identifier must be unique. Typically, you use a reverse-DNS format for bundle ID strings, like com.organization.brand.uniqueidentifier. You can use the same bundle identifier that you have used at Define bundle identifier.
Similarly, use a unique URL scheme, and replace the already provided lumatutorialswiftui with your unique URL scheme.

To learn more about URL Schemes in iOS, review .

Assurance works by opening a URL, either via a browser or QR code. That URL begins with the base URL which opens the app and contains additional parameters. Those unique parameters are used to connect the session. In the example app, the deep link is lumatutorialswiftui://.

1. Go to the Android view of your project in Android Studio.

2. Select app > manifests > AndroidManifest.xml in the navigator.

3. Ensure the manifest > application > activity XML element looks like:

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Ensure you specify an android:scheme (for example. lumatutorialandroid) and android:host (for example default) to define the base URL.

To learn more about deep links in Android, see .

Assurance works by opening a URL, either via a browser or QR code. That URL begins with the base URL, which opens the app and contains additional parameters. Those unique parameters are used to connect the session. In the example app, the deep link is lumatutorialandroid://default.

In Xcode:

1. Build or rebuild and run the app in the simulator or on a physical device from Xcode, using .

   Optionally, you might want to clean your build, especially when you see unexpected results. Select Clean Build Folder鈥� from the Xcode Product menu.

2. In the Allow 鈥淟uma App鈥� to use your location dialog, select Allow While Using App.

   {width="300"}

3. In the 鈥淟uma App鈥� Would Like to Send You Notifications dialog, select Allow.

   {width="300"}

4. Select 颁辞苍迟颈苍耻别鈥� to allow the app to track your activity.

   {width="300"}

5. In the Allow 鈥淟uma App鈥� to track your activity across other companies鈥� apps and websites dialog, select Allow.

   {width="300"}

6. Select Continue.

In your browser:

1. Go to the Data Collection UI.

2. Select Assurance from the left rail.

3. Select Create New Session, and the option Deep link connect.

4. Select Start.

5. Provide a Session Name such as Luma Mobile App Session and the Base URL, which is the URL Schemes you entered in Xcode, followed by :// For example: lumatutorialswiftui://

6. Select Next.
   {modal="regular"}

7. In the Create New Session modal dialog:

   If you鈥檙e using a physical device:

   • Select Scan QR Code. To open the app, use the camera on your physical device to scan the QR code and tap the link.

     {modal="regular"}

   If you are using a simulator:

   1. Select Copy Link.

   2. Copy the deep link using and use the deep link to open the app with Safari in the simulator.

      {modal="regular"}

8. When the app loads, you are presented with a modal dialog asking you to enter the PIN shown in step 7.

   {width="300"}

   Enter the PIN and select Connect.

9. If the connection was successful, you see:

   • An Assurance icon floating on top of your app.

     {width="300"}

   • Experience Cloud updates coming through in the Assurance UI, showing:

     1. Experience Events coming from the app.

     2. Details of a selected event.

     3. The device and timeline.

        {modal="regular"}

10. Select Continue to go to the Home screen.

In Android Studio:

1. Build or rebuild and run the app in the simulator or on a physical device from Android Studio, using .

   Optionally, you might want to clean your build, especially when you see unexpected results. Select Clean Project from the Android Studio Build menu.

2. In the Allow Luma Android to send you notifications dialog, select Allow.

   {width="300"}

3. Select Show permission dialog.

   {width="300"}

4. In the Allow Luma Android to access this device鈥檚 location?鈥�

   {width="300"}

   • Select Precise.
   • Select While using the app.

5. Back in the introduction app screen, select Open device settings.

6. In the Location permission screen, select Allow all the time. Then select 鈫� to return to the introduction app screen.

   {width="300"}

7. Select Continue to go to the Home screen.

In your browser:

1. Go to the Data Collection UI.

2. Select Assurance from the left rail.

3. Select Create New Session, and the option Deep link connect.

4. Select Start.

5. Provide a Session Name such as Luma Mobile App Session and the Base URL, which is the android:scheme and android:host you defined in AndroidManifest.xml in Android Studio, separated by :// For example: lumatutorialandroid://default

6. Select Next.
   {modal="regular"}

7. In the Create New Session modal dialog:

   If you鈥檙e using a physical device:

   • Select Scan QR Code. To open the app, use the camera on your physical device to scan the QR code and tap the link.

     {modal="regular"}

   If you are using a simulator:

   1. Select Copy Link.
   2. Copy the deep link using and use the deep link to open the app with Chrome in the simulator.

   {modal="regular"}

   When prompted in Chrome to Continue to Luma Android, select Continue.

8. When the app loads, you are presented with a modal dialog asking you to enter the PIN shown in step 7.

   {width="300"}

   Enter the PIN and select Connect.

9. If the connection was successful, you see:

   • An Assurance icon floating on top of your app.

     {width="300"}

   • Experience Cloud updates coming through in the Assurance UI, showing:

     1. Experience Events coming from the app.

     2. Details of a selected event.

     3. The device and timeline.

        {modal="regular"}

{modal="regular"}

To update your extension versions (for example, Messaging and Optimize) select the package (extension) from Package Dependencies (for example, AEPMessaging) and from the context menu select Update Package. Xcode updates the package dependencies.

{modal="regular"}

If you see outdated extensions, refer to the on how to update your dependency modules for your project.