什么是AppGallery Connect应用内消息服务？

通过AppGallery Connect（简称AGC）的应用内消息（App Messaging）服务，实现用户使用应用时，向活跃用户发送有针对性的消息来鼓励用户使用应用的关键功能，从而吸引这些用户。例如，通过应用内消息，您可以鼓励用户订阅、给出某个关卡的通过提示，或者推荐某个餐厅活动。您可以定制这些消息的外观和形式，并通过事件作为触发器，在关键的时候呈现给用户。

您将建立什么？

在本次Codelab中，您将建立一个集成应用内消息的应用。应用将会根据语言展示AGC上提前创建的不同语言消息。

您将会学到什么？

开发环境及技能要求

运行终端要求

集成AGC应用内消息服务，需要完成以下准备工作：

针对Android Studio开发环境，开发前需集成App Messaging SDK到您的Android Studio项目中。

  1. 登录AppGallery Connect网站，点击"我的项目"。
  2. 在项目下的应用列表中选择需要开通应用内消息服务的应用。
  3. 选择"项目设置"页签，单击"应用"栏下的"agconnect-services.json"下载配置文件。
  4. 将"agconnect-services.json"文件拷贝到应用级根目录下。
  5. 打开Android Studio应用级build.gradle文件，添加如下代码集成App Messaging SDK。 
    dependencies { 
    //配置如下地址 
   implementation 'com.huawei.agconnect:agconnect-appmessaging:1.6.5.300'             
}
  6. 点击界面上的"Sync Now"链接同步已完成的配置。
  1. 登录AppGallery Connect网站，点击"我的项目"。
  2. 在项目列表中找到您的项目，在项目下的应用列表中选择需要开通应用内消息服务的应用。
  3. 点击"增长 > 应用内消息"，进入应用内消息页面，点击"立即开通"。
  4. 重新下载agconnect-services.json文件。
  1. 选择"增长 > 应用内消息"。
  2. 点击"添加应用内消息"。
  3. 配置消息名称和消息描述。
  4. 设置样式和内容，本次Codelab选择创建Banner消息，其余信息可自行填写。完成后点击"下一步"。
  5. 设置发送目标，新增条件为应用并选择当前应用的应用包名。
  6. 新增条件为语言并选择您希望应用内消息展示的第一种语言，这里以简体中文为例。
  7. 设置发送时间，如下图设置，意为在应用在前台或启动时展示。
  8. 标记转化事件无需设置，直接点击右上角 "发布"按钮发布设置。
  9. 按照以上4-8步再创建一条消息，设置发送目标时语言选择"英语"，其他设置项以语言为标准与前一条进行区分。

本次Codelab无需特殊布局，默认布局即可。
  1. 运行Android Studio工程生成APK包，并在测试手机中安装APK包。
  2. 将手机语言设置为设置项中的简体中文后打开应用会展示第一种语言的消息。
  3. 将手机语言设置为英语后打开应用会展示第二种语言的消息。

祝贺您，您已经成功地构建了您的第一个集成AGC 应用内消息服务的应用程序，并学到了如何集成App Messaging SDK，以及如何在AGC管理台创建新的消息。

 Code copied