创建和发送推送通知

以下步骤并非特定于Adobe Experience Cloud，而是旨在引导您完成APN配置。

1. 在Apple开发人员门户中，导航到​ 密钥。

2. 要创建密钥，请选择​ +。

   {modal="regular"}

3. 提供​ 密钥名称。

4. 选择​ Apple推送通知服务 (APN)，然后选择​ 配置。

   1. 在​ 配置键 ​屏幕中，从​ 环境 ​下拉菜单中选择​ 沙盒和生产。
   2. 选择​ 保存。

5. 选择​ 继续。

   {modal="regular"}

6. 查看配置并选择​ 注册。

7. 下载.p8私钥。 当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。

8. 记下​ 密钥ID。 当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。

9. 记下​ 团队ID。 当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。 团队ID可在屏幕右上角登录名旁边找到。
   {modal="regular"}

其他文档可在此处找到。

以下步骤并非特定于Adobe Experience Cloud，而是旨在引导您完成Firebase配置。

1. 访问Firebase控制台。

2. 选择​ 创建Firebase项目。

   1. 输入​ 项目名称。
   2. 在​ 创建项目 ​中选择​ 继续 - 让我们为您的项目起一个名称。 例如：Luma Android App.
   3. 在Firebase中禁用​ Gemini，并在​ 创建项目 ​中选择​ 继续 - Firebase项目的AI帮助。
   4. 为此项目​ 禁用 Google Analytics，并在​ 为您的Firebase项目创建项目 - Google Analytics ​中选择​ 继续。
   5. 选择​ 创建项目。
   6. 项目就绪后，选择​ 继续。

3. 返回到Firebase控制台，确保在顶部选择您的项目。 例如，Luma Android应用程序。

   {modal="regular"}

4. 选择 > 项目设置。

5. 在​ 项目设置 ​中，选择​ 添加应用程序。

   1. 在​ 将Firebase添加到应用程序 ​中，选择​ Android ​作为平台。

   2. 在​ 将Firebase添加到您的Android应用程序中：

      1. 在步骤1，注册应用程序：

         1. 输入Android包名称，该名称与您的应用程序标识符类似。 例如：com.adobe.luma.tutorial.android。
         2. 输入可选的​ 应用程序昵称。
         3. 选择​ 注册应用程序。

      2. 在步骤2中，下载配置文件，然后添加该文件。

         1. 选择 下载google-services.json。 当您构建自己的Android应用程序版本时，您应该将示例Android Studio项目中的当前google-services.json文件替换为由此新应用程序配置生成的文件版本。
            其他步骤已在示例应用程序中完成。

   您的屏幕应如下所示：

   {modal="regular"}

6. 在​ 项目设置 ​中，选择​ 服务帐户。

7. 选择​ 生成新的私钥。 已生成luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json文件。 将此文件存储在安全位置，因为您以后需要此文件。

有关详细信息，请参阅Firebase开发人员文档。

1. 在Xcode中，从​ Luma TARGETS 列表中选择，选择​ 签名和功能 ​选项卡，选择​ +功能 ​按钮，然后选择​ 推送通知。 此选项使您的应用程序能够接收推送通知。

2. 接下来，您必须向应用程序添加通知扩展。 返回​ General ​选项卡并选择​ 目标 ​部分底部的​ + ​图标。

3. 系统将提示您为新目标选择模板。 选择​ 通知服务扩展，然后选择​ 下一步。

4. 在下一个窗口中，使用NotificationExtension作为扩展的名称，然后单击​ 完成 ​按钮。

现在，您应该将推送通知扩展添加到应用程序中，类似于以下屏幕。

{modal="regular"}

已为推送通知设置了Android Studio项目。 您无需执行其他步骤即可为推送通知启用Android版本的Luma应用程序。 有关详细信息，请参阅关于通知。

Android推送通知要求您在应用程序中和在发送推送通知时定义通知渠道id。 Android Luma应用中使用的渠道通知ID为LUMA_CHANNEL ID。

1. 在Xcode中，确保将AEP消息添加到包依赖关系中的包列表中。 请参阅Swift包管理器。

2. 在Xcode项目导航器中导航到​ Luma > Luma > AppDelegate。

3. 确保AEPMessaging是导入列表的一部分。

   import AEPMessaging

4. 请确保Messaging.self是正在注册的扩展数组的一部分。

   code language-swift
   let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]

1. 在Android Studio中，确保aepsdk-messing-android是​ Android:app ChevronDown ​ ​Gradle脚本 build.gradle.kts （模块​ ） ​的依赖项的一部分。 查看Gradle。

2. 在Android Studio项目导航器中导航到​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

3. 确保com.adobe.marketing.mobile.Messaging是导入列表的一部分。

   import import com.adobe.marketing.mobile.Messaging

4. 请确保Messaging.EXTENSION是正在注册的扩展数组的一部分。

   code language-kotlin
   val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )

1. 在Xcode项目导航器中导航到​ Luma > Luma > AppDelegate。

2. 将MobileCore.setPushIdentifier API添加到func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data)函数。

   code language-swift
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(deviceToken)

   此函数检索与安装应用程序的设备特有的设备令牌。 然后，使用您设置的依赖于Apple推送通知服务(APN)的配置来设置推送通知投放令牌。

1. 在Android Studio项目导航器中导航到​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

2. 在MobileCore.setPushIdentifier中将override fun onCreate() API添加到class LumaAplication : Application中的FirebaseMessaging.getInstance().token.addOnCompleteListener函数。

   code language-kotlin
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(token)

   此函数检索与安装应用程序的设备特有的设备令牌。 然后，使用您设置的依赖于Firebase Cloud Messaging (FCM)的配置来设置推送通知投放令牌。

1. 在Xcode项目导航器中导航到​ Luma > Luma > 模型 > XDM > TestPushPayload，并检查代码。

   code language-swift
   import Foundation // MARK: - TestPush struct TestPushPayload: Codable { let application: Application let eventType: String } // MARK: - Application struct Application: Codable { let id: String }

   该代码呈现了您要发送的以下简单有效负载，以触发测试推送通知历程。

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. 在Xcode项目导航器中导航到​ Luma > Luma > Utils > MobileSDK，并将以下代码添加到func sendTestPushEvent(applicationId: String, eventType: String)：

   code language-swift
   // Create payload and send experience event Task { let testPushPayload = TestPushPayload( application: Application( id: applicationId ), eventType: eventType ) // send the final experience event await sendExperienceEvent( xdm: testPushPayload.asDictionary() ?? [:] ) }

   此代码使用提供给函数（testPushPayload和applicationId）的参数创建一个eventType实例，然后在将有效负载转换为字典时调用sendExperienceEvent。 此代码还通过使用Swift的基于await和async的并发模型来考虑调用Adobe Experience Platform SDK的异步方面。

3. 在Xcode项目导航器中导航到​ Luma > Luma > Views > General > ConfigView。 在推送通知按钮定义中，添加以下代码以发送测试推送通知体验事件有效负载，以便在点击该按钮时触发您的历程。

   code language-swift
   // Setting parameters and calling function to send push notification Task { let eventType = testPushEventType let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found" await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType) }

1. 在Android Studio导航器中导航到​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt，并检查代码。

   code language-kotlin

   import com.google.gson.annotations.SerializedName data class TestPushPayload( @SerializedName("application") val application: Application, @SerializedName("eventType") val eventType: String ) { fun asMap(): Map<String, Any> { return mapOf( "application" to application.asMap(), "eventType" to eventType ) } } data class Application( @SerializedName("id") val id: String ) { fun asMap(): Map<String, Any> { return mapOf( "id" to id ) } }

   该代码呈现了您要发送的以下简单有效负载，以触发测试推送通知历程。

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. 在Android Studio导航器中导航到​ Android > app > kotlin+java > com.adobe.luma.tutorial.android > 模型 > MobileSDK，并将以下代码添加到func sendTestPushEvent(applicationId: String, eventType: String)：

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   此代码使用提供给函数（testPushPayload和applicationId）的参数创建一个eventType实例，然后在将有效负载转换为映射时调用sendExperienceEvent。

3. 在Android Studio导航器中导航到​ Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt。 在推送通知按钮定义中，添加以下代码以发送测试推送通知体验事件有效负载，以便在点击该按钮时触发您的历程。

   code language-kotlin
   // Setting parameters and calling function to send push notification val eventType = testPushEventType val applicationId = context.packageName scope.launch { MobileSDK.shared.sendTestPushEvent( applicationId, eventType ) }

1. 使用 ，在模拟器中或在Xcode的物理设备上重建并运行应用程序。

2. 转到​ 设置 ​选项卡。

3. 点按​ 推送通知。

   您会看到推送通知显示在应用程序顶部。

   {width="300"}

1. 使用 ，在模拟器中或在Android Studio的物理设备上重建并运行应用程序。

2. 转到​ 设置 ​选项卡。

3. 点按​ 推送通知。

   您会看到推送通知显示在应用程序顶部。

   {width="300"}