Assurance instellen

Naast de algemene installatie van SDK, vereist iOS ook de volgende extra code om de zitting van Assurance voor uw app te beginnen.

1. Navigeer naar Luma > Luma > SceneDelegate in de projectnavigator van uw Xcode.

2. Voeg de volgende code toe aan 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) }

   Met deze code wordt een verzekeringssessie gestart wanneer de toepassing op de achtergrond wordt uitgevoerd en via een diepe koppeling wordt geopend.

Naast de algemene installatie van SDK, vereist Android ook de volgende extra code om de zitting van Assurance voor uw app te beginnen.

1. Navigeer in Android Studio in de Android -weergave naar app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication .

2. Voeg de volgende code toe aan 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)

   Met deze code wordt een verzekeringssessie gestart wanneer de toepassing op de achtergrond wordt uitgevoerd en via een diepe koppeling wordt geopend.

1. Open het project in Xcode.
2. Selecteer Luma in de projectnavigator.
3. Selecteer het doel Luma .
4. Selecteer het Ondertekenen & Capabilities lusje.
5. Definieer een Bundle Identifier .

Verzeker u a uniek bundelherkenningsteken gebruikt en vervang het com.adobe.luma.tutorial.swiftui bundelherkenningsteken, aangezien elk bundelherkenningsteken uniek moet zijn. Gewoonlijk gebruikt u een omgekeerde DNS-indeling voor bundle ID-tekenreeksen, zoals com.organization.brand.uniqueidentifier . De voltooide versie van deze zelfstudie gebruikt bijvoorbeeld com.adobe.luma.tutorial.swiftui .

{modal="regular"}

1. Open het project in Android Studio.
2. Selecteer build.gradle.kts (Module :app) in de navigator.
3. Verzeker u a uniek bundelherkenningsteken gebruikt en vervang de com.adobe.luma.tutorial.android waarde voor namespace in android
4. Verzeker u het zelfde unieke bundelherkenningsteken gebruikt com.adobe.luma.tutorial.android voor applicationId binnen defaultConfig in android

Gewoonlijk gebruikt u een omgekeerde DNS-indeling voor bundle ID-tekenreeksen, zoals com.organization.brand.uniqueidentifier . De voltooide versie van deze zelfstudie gebruikt bijvoorbeeld com.adobe.luma.tutorial.android .

{modal="regular"}

1. Ga naar uw project in Xcode.

2. Selecteer Luma in de projectnavigator.

3. Selecteer het doel Luma .

4. Selecteer het Info lusje.

5. Om een basis URL toe te voegen, scrol neer aan Types URL en selecteer + knoop.

6. Plaats Herkenningsteken aan het bundelherkenningsteken van uw keus en plaats a Schema's URL van uw keus.

   {modal="regular"}

Verzeker u a uniek bundelherkenningsteken gebruikt en vervang het com.adobe.luma.tutorial.swiftui bundelherkenningsteken, aangezien elk bundelherkenningsteken uniek moet zijn. Gewoonlijk gebruikt u een omgekeerde DNS-indeling voor bundle ID-tekenreeksen, zoals com.organization.brand.uniqueidentifier . U kunt het zelfde bundelherkenningsteken gebruiken dat u bij hebt gebruikt bepaalt bundelherkenningsteken.
Op dezelfde manier gebruik een uniek schema URL, en vervang reeds verstrekt lumatutorialswiftui met uw uniek schema URL.

Meer over regelingen URL in iOS leren, herzie documentatie van Apple.

Assurance werkt door een URL te openen, via een browser of QR-code. Die URL begint met de basis-URL die de app opent en aanvullende parameters bevat. Deze unieke parameters worden gebruikt om de sessie te verbinden. In de voorbeeld-app is de diepe koppeling lumatutorialswiftui:// .

1. Ga naar de Android weergave van uw project in Android Studio.

2. Selecteer app > manifests > AndroidManifest.xml in de navigator.

3. Zorg ervoor dat het XML-element manifest > application > activity er als volgt uitziet:

   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>

Zorg ervoor dat u een android:scheme opgeeft (bijvoorbeeld lumatutorialandroid ) en android:host (bijvoorbeeld default ) om de basis-URL te definiëren.

Meer over diepe verbindingen in Android leren, zie Diepe Verbindingen tot de Inhoud van de Toepassingcreëren.

Assurance werkt door een URL te openen, via een browser of QR-code. Die URL begint met de basis-URL, die de app opent en aanvullende parameters bevat. Deze unieke parameters worden gebruikt om de sessie te verbinden. In de voorbeeld-app is de diepe koppeling lumatutorialandroid://default .

In Xcode:

1. Bouw of herbouwt en stel app in de simulator of op een fysiek apparaat van Xcode in werking, gebruikend .

   Naar keuze, zou u ​ uw bouwstijl kunnen willen schoonmaken, vooral wanneer u onverwachte resultaten ziet. Selecteer ​ Clean Build Folder… ​ in het menu Xcode ​ Product** .

2. Selecteer Allow “Luma App” to use your location in het dialoogvenster Allow While Using App .

   {width="300"}

3. Selecteer “Luma App” Would Like to Send You Notifications in het dialoogvenster Allow .

   {width="300"}

4. Selecteer Continue… om toe te staan dat de app uw activiteiten bijhoudt.

   {width="300"}

5. Selecteer Allow “Luma App” to track your activity across other companies’ apps and websites in het dialoogvenster Allow .

   {width="300"}

6. Selecteer Continue.

In uw browser:

1. Ga naar de interface voor gegevensverzameling.

2. Selecteer Assurance in het linkerspoor.

3. Selecteer Create New Session en kies de optie Deep link connect .

4. Selecteer Start.

5. Geef een Session Name zoals Luma Mobile App Session en Base URL op. Dit zijn de URL-schema's die u in Xcode hebt ingevoerd, gevolgd door :// Bijvoorbeeld: lumatutorialswiftui://

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

7. In het modale dialoogvenster Create New Session :

   Als u een fysiek apparaat gebruikt:

   • Selecteer Scan QR Code. Als u de app wilt openen, gebruikt u de camera op het fysieke apparaat om de QR-code te scannen en tikt u op de koppeling.

     {modal="regular"}

   Als u een simulator gebruikt:

   1. Selecteer Copy Link.

   2. Kopieer de diepe verbinding gebruikend en gebruik de diepe verbinding om app met Safari in de simulator te openen.

      {modal="regular"}

8. Wanneer de app wordt geladen, ziet u een modaal dialoogvenster waarin u wordt gevraagd de pincode in te voeren die in stap 7 wordt getoond.

   {width="300"}

   Voer de pincode in en selecteer Connect .

9. Als de verbinding tot stand is gebracht, ziet u:

   • Een Assurance-pictogram dat boven op uw app zweeft.

     {width="300"}

   • Experience Cloud-updates die worden weergegeven in de gebruikersinterface van Assurance:

     1. Ervaar gebeurtenissen die afkomstig zijn uit de app.

     2. Details van een geselecteerde gebeurtenis.

     3. Het apparaat en de tijdlijn.

        {modal="regular"}

10. Selecteer Continue om naar het scherm Home te gaan.

In Android Studio:

1. Bouw of herbouwt en stel app in de simulator of op een fysiek apparaat van de Studio van Android in werking, gebruikend .

   Naar keuze, zou u ​ uw bouwstijl kunnen willen schoonmaken, vooral wanneer u onverwachte resultaten ziet. Selecteer ​ Clean Project ​ in het menu Android Studio ​ Build** .

2. Selecteer Allow Luma Android to send you notifications in het dialoogvenster Allow .

   {width="300"}

3. Selecteer Show permission dialog.

   {width="300"}

4. In de lus Allow Luma Android to access this device’s location?…

   {width="300"}

   • Selecteer Precise.
   • Selecteer While using the app.

5. Selecteer Open device settings weer in het scherm van de introductieapp.

6. Selecteer Location permission in het Allow all the time -scherm. Selecteer vervolgens ← om terug te keren naar het startscherm van de app.

   {width="300"}

7. Selecteer Continue om naar het scherm Home te gaan.

In uw browser:

1. Ga naar de interface voor gegevensverzameling.

2. Selecteer Assurance in het linkerspoor.

3. Selecteer Create New Session en kies de optie Deep link connect .

4. Selecteer Start.

5. Geef een Session Name zoals Luma Mobile App Session en de Base URL op. Dit zijn de android:scheme en android:host die u in AndroidManifest.xml in Android Studio hebt gedefinieerd, gescheiden door :// bijvoorbeeld: lumatutorialandroid://default

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

7. In het modale dialoogvenster Create New Session :

   Als u een fysiek apparaat gebruikt:

   • Selecteer Scan QR Code. Als u de app wilt openen, gebruikt u de camera op het fysieke apparaat om de QR-code te scannen en tikt u op de koppeling.

     {modal="regular"}

   Als u een simulator gebruikt:

   1. Selecteer Copy Link.
   2. Kopieer de diepe verbinding gebruikend en gebruik de diepe verbinding om app met Chrome in de simulator te openen.

   {modal="regular"}

   Wanneer ertoe aangezet in Chrome aan Luma Android verdergaan, uitgezochte gaat verder.

8. Wanneer de app wordt geladen, ziet u een modaal dialoogvenster waarin u wordt gevraagd de pincode in te voeren die in stap 7 wordt getoond.

   {width="300"}

   Voer de pincode in en selecteer Connect .

9. Als de verbinding tot stand is gebracht, ziet u:

   • Een Assurance-pictogram dat boven op uw app zweeft.

     {width="300"}

   • Experience Cloud-updates die worden weergegeven in de gebruikersinterface van Assurance:

     1. Ervaar gebeurtenissen die afkomstig zijn uit de app.

     2. Details van een geselecteerde gebeurtenis.

     3. Het apparaat en de tijdlijn.

        {modal="regular"}

{modal="regular"}

Als u uw extensieversies wilt bijwerken (bijvoorbeeld Messaging en Optimize ), selecteert u het pakket (de extensie) in Package Dependencies (bijvoorbeeld AEPMessaging ) en selecteert u Update Package in het contextmenu. Xcode werkt de pakketafhankelijkheden bij.

{modal="regular"}

Als u verouderde uitbreidingen ziet, verwijs naar de documentatie van de Studio van Androidop hoe te om uw gebiedsdeelmodules voor uw project bij te werken.