安装和初始化

要将AppMetrica Push SDK集成到Flutter,请使用AppMetrica Flutter的Push SDK插件:

  1. 在项目中安装AppMetrica Push SDK 插件。 从项目根目录运行命令:

    flutter pub add appmetrica_push_plugin
    

    在添加插件后,你会在 pubspec.yaml 文件中看到一行如下的依赖:

    dependencies:
        appmetrica_push_plugin: ^3.1.0
    
  2. 添加 appmetrica_plugin 和 appmetrica_push_plugin 导入:

    import 'package:appmetrica_plugin/appmetrica_plugin.dart';
    import 'package:appmetrica_push_plugin/appmetrica_push_plugin.dart';
    
  3. 初始化 AppMetrica SDK 库,使用 AppMetrica.activate 和您的 API 密钥:

    AppMetrica.activate(AppMetricaConfig("insert_your_api_key_here"));
    
  4. 使用 AppMetricaPush.activate 并输入 API 密钥来初始化 AppMetricaPush SDK``:

    AppMetricaPush.activate();
    
  5. 要完成推送通知的集成,请参考每种本地平台的文档:

    1. 为使用 Firebase 设置应用 获取并添加到 AppMetrica 用于 Firebase Cloud Messaging 的服务器密钥:

    2. 将Firebase运输连接到android/app/build.gradle文件中,通过添加以下依赖项:

    dependencies {
       implementation "com.google.firebase:firebase-messaging: 22.0.0"
       implementation "com.google.android.gms:play-services-base: 17.5.0"
    }
    

    3. 使用以下方法之一初始化 Firebase 运输:

    使用 Google Services 插件

    1. 下载配置文件google-services.json,并将其放入项目模块目录(例如app)。

    2. 为了文件正常工作,请在项目中启用 Google Services 插件,将以下行添加到 Gradle 文件中:

    project
    • build.gradle.kts

      buildscript {
            dependencies {
               classpath("com.google.gms:google-services:4.4.0")
            }
         }
      
    • build.gradle

      buildscript {
         dependencies {
            classpath "com.google.gms:google-services:4.4.0"
         }
      }
      
    application (module)
    • 应用/build.gradle.kts

      apply(plugin = "com.google.gms.google-services")
      
    • app/build.gradle

      apply plugin: "com.google.gms.google-services"
      
    不使用插件

    在 应用 元素中修改 AndroidManifest.xml 文件:

    <meta-data android:name="ymp_firebase_default_app_id" android:value="APP_ID"/>
    <meta-data android:name="ymp_gcm_default_sender_id" android:value="number:SENDER_ID"/>
    <meta-data android:name="ymp_firebase_default_api_key" android:value="API_KEY"/>
    <meta-data android:name="ymp_firebase_default_project_id" android:value="PROJECT_ID"/>
    

    APP_ID — 应用在 Firebase 中的 ID。 您可以在 Firebase 控制台 中找到它:转到 项目设置。 在 您的应用 部分,复制 应用 ID 字段的值。

    SENDER_ID — Firebase 中发送者的唯一 ID。 您可以在 Firebase 控制台 中找到它:转到 项目设置 → 云消息传递,并复制 发送者 ID 字段的值。

    API_KEY — Firebase 中的应用密钥。 您可以在 google-services.json 文件的 current_key 字段中找到它。 您可以在 Firebase 控制台 中下载该文件。

    PROJECT_ID — Firebase 中的应用 ID。 您可以在 google-services.json 文件的 project_id 字段中找到它。 您可以在 Firebase 控制台 中下载该文件。

    使用其他 Firebase 项目

    在 应用 元素中修改 AndroidManifest.xml 文件:

    <meta-data android:name="ymp_firebase_app_id" android:value="APP_ID"/>
    <meta-data android:name="ymp_gcm_sender_id" android:value="number:SENDER_ID"/>
    <meta-data android:name="ymp_firebase_api_key" android:value="API_KEY"/>
    <meta-data android:name="ymp_firebase_project_id" android:value="PROJECT_ID"/>
    

    APP_ID — 应用在 Firebase 中的 ID。 您可以在 Firebase 控制台 中找到它:转到 项目设置。 在 您的应用 部分,复制 应用 ID 字段的值。

    SENDER_ID — Firebase 中发送者的唯一 ID。 您可以在 Firebase 控制台 中找到它:转到 项目设置 → 云消息传递,并复制 发送者 ID 字段的值。

    API_KEY — Firebase 中的应用密钥。 您可以在 google-services.json 文件的 current_key 字段中找到它。 您可以在 Firebase 控制台 中下载该文件。

    PROJECT_ID — Firebase 中的应用 ID。 您可以在 google-services.json 文件的 project_id 字段中找到它。 您可以在 Firebase 控制台 中下载该文件。

    注意

    您应该初始化默认的Firebase项目。

    4. 如果需要,配置静默推送通知 或 启用推送令牌更新。

    1. 将SSL证书添加到AppMetrica,按照说明操作。

    2. 将Capability Push Notifications添加到您的XCode项目中。

    3. 如果需要,启用推送令牌更新 或 配置附件文件上传。

    4. 设置统计数据收集。

如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。

联系支持 为文档提出改进建议
上一篇
下一篇