---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/sdk/flutter/push/quick-start.md
  - https://boost.yandex.com/doc/ru/analytics/content/sdk/flutter/push/quick-start.md
  - https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/push/quick-start.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/push/quick-start.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739

# 安装和初始化

要将AppMetrica Push SDK集成到Flutter，请使用[AppMetrica Flutter的Push SDK](https://pub.dev/packages/appmetrica_push_plugin)插件：

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

   ```bash translate=no
   flutter pub add appmetrica_push_plugin
   ```

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

   ```java translate=no
   dependencies:
       appmetrica_push_plugin: ^3.1.0
   ```

2. 添加 `appmetrica_plugin` 和 `appmetrica_push_plugin` 导入:

   ```java translate=no
   import 'package:appmetrica_plugin/appmetrica_plugin.dart';
   import 'package:appmetrica_push_plugin/appmetrica_push_plugin.dart';
   ```

3. 初始化 AppMetrica SDK 库，使用 `AppMetrica.activate` 和您的 API 密钥：

   ```bash translate=no
   AppMetrica.activate(AppMetricaConfig("insert_your_api_key_here"));
   ```

4. 使用 AppMetricaPush.activate 并输入 API 密钥来初始化 AppMetricaPush SDK``：

   ```bash translate=no
   AppMetricaPush.activate();
   ```

5. 要完成推送通知的集成，请参考每种本地平台的文档：

   {% list tabs %}

   - Android

      1\. [为使用 Firebase 设置应用](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/android-settings.md#firebase) [获取并添加到 AppMetrica](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/android-settings.md#firebase-key) 用于 Firebase Cloud Messaging 的服务器密钥：

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

      ```kotlin translate=no
      dependencies {
         implementation "com.google.firebase:firebase-messaging: 22.0.0"
         implementation "com.google.android.gms:play-services-base: 17.5.0"
      }
      ```

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

      {% cut "使用 Google Services 插件" %}

      1\. [下载](https://support.google.com/firebase/answer/7015592)配置文件`google-services.json`，并将其放入项目模块目录（例如`app`）。

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

      ##### project

      * **build.gradle.kts**

         ```kotlin translate=no
         buildscript {
               dependencies {
                  classpath("com.google.gms:google-services:4.4.0")
               }
            }
         ```

      * **build.gradle**

         ```groovy translate=no
         buildscript {
            dependencies {
               classpath "com.google.gms:google-services:4.4.0"
            }
         }
         ```

      ##### application (module)

      * **应用/build.gradle.kts**

         ```kotlin translate=no
         apply(plugin = "com.google.gms.google-services")
         ```

      * **app/build.gradle**

         ```groovy translate=no
         apply plugin: "com.google.gms.google-services"
         ```

      {% endcut %}

      {% cut "不使用插件" %}

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

      ```xml translate=no
      <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 控制台](https://console.firebase.google.com/) 中找到它：转到 **项目设置**。 在 **您的应用** 部分，复制 **应用 ID** 字段的值。


      `SENDER_ID` — Firebase 中发送者的唯一 ID。 您可以在 [Firebase 控制台](https://console.firebase.google.com/) 中找到它：转到 **项目设置**&nbsp;→ **云消息传递**，并复制 **发送者 ID** 字段的值。


      `API_KEY` — Firebase 中的应用密钥。 您可以在 `google-services.json` 文件的 `current_key` 字段中找到它。 您可以在 [Firebase 控制台](https://support.google.com/firebase/answer/7015592) 中下载该文件。


      `PROJECT_ID` — Firebase 中的应用 ID。 您可以在 `google-services.json` 文件的 `project_id` 字段中找到它。 您可以在 [Firebase 控制台](https://console.firebase.google.com/) 中下载该文件。


      {% endcut %}

      {% cut "使用其他 Firebase 项目" %}

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

      ```xml translate=no
      <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 控制台](https://console.firebase.google.com/) 中找到它：转到 **项目设置**。 在 **您的应用** 部分，复制 **应用 ID** 字段的值。


      `SENDER_ID` — Firebase 中发送者的唯一 ID。 您可以在 [Firebase 控制台](https://console.firebase.google.com/) 中找到它：转到 **项目设置**&nbsp;→ **云消息传递**，并复制 **发送者 ID** 字段的值。


      `API_KEY` — Firebase 中的应用密钥。 您可以在 `google-services.json` 文件的 `current_key` 字段中找到它。 您可以在 [Firebase 控制台](https://support.google.com/firebase/answer/7015592) 中下载该文件。


      `PROJECT_ID` — Firebase 中的应用 ID。 您可以在 `google-services.json` 文件的 `project_id` 字段中找到它。 您可以在 [Firebase 控制台](https://console.firebase.google.com/) 中下载该文件。


      {% note alert %}

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

      {% endnote %}

      {% endcut %}

      4\. 如果需要，[配置静默推送通知](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md#settings-of-silent-push) 或 [启用推送令牌更新](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md#actualization)。


   - iOS

      1\. 将SSL证书添加到AppMetrica，按照[说明](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/ios-settings.md)操作。

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

      3\. 如果需要，[启用推送令牌更新](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/quick-start.md#actualization) 或 [配置附件文件上传](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/quick-start.md#download-file)。

      4\. [设置](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/ios-settings.md)统计数据收集。

   {% endlist %}

<!-- source: zh/analytics/content/_includes/feedback-button-3.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button-3.md -->