【AGC】如何在iOS上集成华为AGC应用内消息
【AGC】如何在iOS上集成华为AGC应用内消息
简介
通过AppGallery Connect（简称AGC）的应用内消息（App Messaging）服务，实现用户使用应用时，向活跃用户发送有针对性的消息来鼓励用户使用应用的关键功能，从而吸引这些用户。例如，通过应用内消息，您可以鼓励用户订阅、给出某个关卡的通过提示，或者推荐某个餐厅活动。您可以定制这些消息的外观和形式，并通过事件作为触发器，在关键的时候呈现给用户。
开通服务和集成 SDK
-
在AppGallery Connect页面点击“我的项目”，在项目的应用列表中选择需要开通应用内消息的应用。
-
在导航选择“增长 > 应用内消息”。如果是首次使用应用内消息服务，请点击“立即使用”开通服务。
-
选择常规页签下的“应用”区域，下载
agconnect-services.plist配置文件。 -
打开命令行窗口，导航至Xcode项目所在的位置，创建
Podfile文件。如果已经存在，可跳过本步骤。
cd project-directory
pod init- 编辑
Podfile文件，增加pod依赖pod 'AGConnectAppLinking'。
target 'AGC-AppMessaging-1' do
pod 'AGConnectAppMessaging'
end- 执行
pod install，然后打开xcworkspace文件查看该项目。
pod install安装成功效果如下图。
界面设计
本次Codelab无需特殊布局，默认布局即可。
创建消息
-
在“增长”菜单下选择“应用内消息”，点击“添加应用内消息”。
-
填写消息名称和消息描述。
-
设置样式和内容，本次Codelab选择创建Banner消息。消息标题和正文分别设置为“Codelab English Ver.”和“Welcome to Codelab”，其余信息可自行填写，完成后点击下一步。
-
设置发送目标，默认条件为应用，选择当前应用的应用包名。本次Codelab需要针对中英文语言展示不同的应用内消息，点击“新增条件”，选择“语言”，这里选择“英语”。
-
设置发送时间，如下图设置，意在为应用在前台或启动时展示。
-
标记转化事件按默认设置即可，设置完成后，点击右上角“发布”。
-
按照1~6步骤再创建一条消息，消息标题和正文分别设置为“Codelab中文版”和“欢迎来到Codelab”，并将发送目标语言设置为“中文简体”，以区分中文版。
功能开发
- 在应用的AppDelegate类中引入AGConnectCore和AGConnectAppMessaging库，并在
didFinishLaunchingWithOptions方法里调用AGCInstance.startUp进行初始化。
import AGConnectCore
import AGConnectAppMessaging
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
AGCInstance.startUp()
return true
}打包测试
-
将手机或模拟器上的语言设置为简体中文。运行Xcode，在设备上安装应用，打开应用后，展示中文的应用内消息。
-
将语言设置成英文。在手机或模拟器上删除本应用，重新运行安装，打开应用后，展示英文的应用内消息。
恭喜您
祝贺您，您已经成功地构建了您的第一个集成AGC应用内消息服务的应用程序，并学到了如何集成应用内消息的SDK， 以及如何在AGC管理台创建和调试新的消息。
参考文档
在iOS上集成华为AGC（AppGallery Connect）应用内消息功能，首先需要在AGC控制台创建项目并启用应用内消息服务。然后，在Xcode项目中集成AGC SDK。具体步骤如下：
-
创建AGC项目：登录AGC控制台，创建一个新项目，并在项目设置中启用“应用内消息”服务。
-
集成AGC SDK：在Xcode项目中，通过CocoaPods或手动方式集成AGC SDK。在Podfile中添加以下依赖：
pod 'AGConnectAppMessaging'然后运行
pod install安装依赖。 -
初始化AGC SDK：在AppDelegate的
application:didFinishLaunchingWithOptions:方法中初始化AGC SDK：#import <AGConnectCore/AGConnectCore.h> #import <AGConnectAppMessaging/AGConnectAppMessaging.h> - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [AGCInstance startUp]; [AGCAppMessaging sharedInstance]; return YES; } -
配置应用内消息：在AGC控制台中配置应用内消息的内容、触发条件和展示样式。
-
处理消息事件：可以通过实现
AGCAppMessagingDelegate协议来处理消息的展示和点击事件：[@interface](/user/interface) YourViewController () <AGCAppMessagingDelegate> [@end](/user/end) [@implementation](/user/implementation) YourViewController - (void)viewDidLoad { [super viewDidLoad]; [AGCAppMessaging sharedInstance].delegate = self; } - (void)appMessaging:(AGCAppMessaging *)appMessaging didDisplayMessage:(AGCAppMessagingDisplayMessage *)message { // 处理消息展示事件 } - (void)appMessaging:(AGCAppMessaging *)appMessaging didClickMessage:(AGCAppMessagingDisplayMessage *)message { // 处理消息点击事件 } [@end](/user/end)
通过以上步骤，即可在iOS应用中集成华为AGC应用内消息功能。
在iOS上集成华为AGC（AppGallery Connect）应用内消息，首先需在AGC控制台启用该服务。接着，通过CocoaPods添加AGConnectAppMessaging依赖。在AppDelegate中，使用import AGConnectAppMessaging导入模块，并在application(_:didFinishLaunchingWithOptions:)方法中调用AGConnectAppMessaging.sharedInstance().start()启动服务。最后，在AGC控制台配置消息模板并发送，即可在应用中接收和展示应用内消息。确保项目已集成AGC Core SDK，并正确配置agconnect-services.plist文件。
