Android GMS集成

一、需求

        由于公司业务的需要，客户要发布海外版本，故需要内置google服务。
        GMS规范化的集成，需要跟Google签MADA等协议，而对于普通的Rom开发团队来说，是很难有资质去跟google要资源。
        故有必要去了解一下Android GMS相关知识，才能更好地理解GMS集成的流程。

二、环境

1. 平台：UIS7870
2. 版本：Android 13
3. 梯子：一元机场

三、相关概念

3.1 Google GMS

        Google GMS（Google Mobile Services，谷歌移动服务）是谷歌为安卓（Android）设备提供的一套核心应用、API（应用程序接口）和服务的集合。它不属于安卓开源系统（AOSP）的一部分，而是由谷歌授权给设备制造商，需通过谷歌认证才能预装在设备上。

1、核心应用：

• Google Play 商店（应用下载平台）
• Gmail、YouTube、Google Maps、Chrome 等谷歌官方应用
• Google Drive、Google Photos 等云服务
• Google 搜索和语音助手（Google Assistant）

2、底层服务与 API：

• 服务：提供推送通知、账号同步、定位、地图服务等基础功能。
• 安全服务：如 Google Play Protect（病毒扫描）、设备定期安全更新。
• 开发接口：如 Firebase（云服务）、Google Sign-In（账号登录）、地图 SDK 等，帮助开发者集成谷歌功能。

3.2 MADA协议

        MADA协议（Mobile Application Distribution Agreement，移动应用分发协议）是谷歌与安卓设备制造商（如手机厂商）之间签署的核心商业协议，用于规范谷歌移动服务（GMS）在设备上的预装和分发。该协议是设备厂商获得GMS授权的前提，也是谷歌控制安卓生态的关键手段。

1、强制预装谷歌应用
厂商若想预装Google Play商店等GMS服务，必须按照协议要求捆绑安装一整套谷歌应用（称为“GMS全家桶”），例如：

• Google Play商店、Google搜索、Chrome浏览器
• YouTube、Gmail、Google Maps、Google Drive等。
• 部分协议版本还要求将Google搜索设为默认搜索引擎，并在主屏固定显示“Google文件夹”。

2、限制竞争对手服务
协议中可能包含排他性条款，例如：

• 禁止厂商在设备上预装与谷歌服务直接竞争的第三方应用（如其他应用商店或搜索引擎）。
• 限制厂商开发或推广基于安卓分支（如AOSP）的衍生系统。

3、分成与利益绑定

• 谷歌通过预装应用获取用户流量和广告收入，例如Google搜索的广告分成。
• 厂商需配合谷歌的服务更新和安全策略（如定期推送Google Play服务更新）

四、GMS全家桶

        目前网上有很多GMS相关的app和服务框架，但是各种东拼西凑，适配到项目上后，可能会有七七八八的问题（闪退、权限、商店无法下载app等），很容易怀疑人生。如下推荐几个Gapps套件的下载地址，亲测可行，大家可按需下载。

4.1 OpenGapps

        Open GApps 是一个开源项目，旨在为 Android 设备提供 Google Apps 的预构建包。该项目的主要目标是简化用户在非 Google 官方发布的 Android 设备上安装 Google 服务的过程。Open GApps 支持多种架构，包括 arm, arm64, x86 和 x86_64，并且提供了多种不同的 GApps 包，以满足不同用户的需求。
        OpenGApps目前仅支持Android4.4-Android11版本‌，目前不再维护。

        下载地址： https://opengapps.org/

4.1.1 OpenGapps版本差异

ps：具体差异可以参考:https://huaweicloud.csdn.net/64eeac4ca3cccc782cc57e9f.html

4.1.2 OpenGapps批量解压

解压缩： find -name '*.lz' |xargs lzip -d
解tar包： for file in *.tar; do tar xvf $file; done

4.2 MindTheGapps

        ‌MindTheGapps‌是一个为Android设备提供的Google应用服务框架（GApps）套件，由Howard Wu和S1204开发，目前仅支持Android9.0之后的版本。

        下载地址： https://sourceforge.net/projects/wsa-mtg/files/

4.3 NikGApps

        NikGApps‌是一个专为Android用户设计的开源项目，旨在提供自定义的Google Apps软件包。支持 Android 15 (V)、14 (U)（定期更新）和 Android 13 (T)、12L (SL)、12 (S)、11 ®、10 (Q)（根据需要
        下载地址： https://nikgapps.com/

4.4 BitGapps

        BiTGApps是一个定制的谷歌应用程序包，用于在自定义Android操作系统中加载谷歌应用程序。支持Android 15.0到7.1版本。
        下载地址： https://bitgapps.io/#google_vignette

4.5 ApkMirror

‌        APKMirror‌是一个广受赞誉的APK镜像网站，提供各种版本的APK文件下载，包括最新版本和历史版本。该网站每日更新，涵盖不同架构和DPI的APK，确保用户能够找到适合自己的安装包‌
        下载地址： https://apk-mirror.net/

五、GMS集成

        谷歌全家桶中有三个是核心应用，必须安装的：GoogleServicesFramework、GmsCore、GooglePlayStore，其他应用根据需要安装即可。

5.1 应用集成

        这三个应用是Android系统的核心组件，需要与系统深度集成，普通用户无法直接安装。

5.1.1 应用目录

xxx/partner_gms$ tree
.
├── apps
│   ├── GoogleServicesFramework
│   │   ├── Android.mk
│   │   └── GoogleServicesFramework.apk
│   ├── Phonesky
│   │   ├── Android.mk
│   │   └── Phonesky.apk
│   └── PrebuiltGmsCore
│       ├── Android.mk
│       └── PrebuiltGmsCore.apk
├── permissions
│   ├── default-permissions.xml
│   ├── privapp-permissions-google.xml
│   └── split-permissions-google.xml
├── products
│   └── gms.mk
└── readme.txt

5.1.2 应用mk脚本

Step 1. 如下为GoogleServicesFramework.mk，其他两个应用也类似处理即可。

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE := GoogleServicesFramework
LOCAL_MODULE_CLASS := APPS
LOCAL_CERTIFICATE := PRESIGNED
LOCAL_ENFORCE_USES_LIBRARIES := false
LOCAL_DEX_PREOPT := false
LOCAL_MODULE_PATH := $(TARGET_OUT)/priv-app
LOCAL_SRC_FILES := GoogleServicesFramework.apk
include $(BUILD_PREBUILT)

Step 2. gms.mk需要将三个模块，打包到Android系统。

$(warning cheerzing gms.mk)
PRODUCT_PACKAGES += Phonesky \
    GoogleServicesFramework \
    PrebuiltGmsCore \

5.2 权限处理

Step 1. 当我们将app扔进system分区后，重启设备后，开机log会发现一堆密密麻麻的错误信息。那是因为GMS全家桶中，有一些应用需要申请权限，但是这些权限在系统中是没有的，需要我们手动添加。

Step 2. 遇事不要慌，先到Gapp套件下，一般会有对应应用需要配置的权限，拷贝过来即可。我们需要将权限文件预置到system/etc/permissions/目录下。如下为OpenGapps相关权限文件：

Step 3. gms.mk Android系统编译打包进系统

PRODUCT_COPY_FILES += \
	xxx/partner_gms/permissions/privapp-permissions-google.xml:system/etc/permissions/privapp-permissions-google.xml \
	xxx/partner_gms/permissions/split-permissions-google.xml:system/etc/permissions/split-permissions-google.xml \
	xxx/partner_gms/permissions/default-permissions.xml:system/etc/permissions/default-permissions.xml

5.3 Google认证

Step 1. 当我们集成了GMS全家桶后，配置了权限，重启设备后，会发现Google Play Store无法打开，提示认证失败。

Step 2. 遇事不要慌，这是因为我们的设备未经认证，需要我们去Google官方认证。按照注册流程，注册一个账号即可。
Goole官方认证： https://www.google.com/android/uncertified/

Step 3. 注册完设备id后，需要将设备的 GoogleServicesFramework、GmsCore、GooglePlayStore三个应用的缓存数据清空并重启应用。

Step 4. 由于每台设备对应的android_id都不一样，我们不可能每台设备都去官网认证。所以…只能在框架层动动手脚了。如下是参考网友的做法，亲测有效，与君共勉。

--- a/core/java/android/content/ContentResolver.java
+++ b/core/java/android/content/ContentResolver.java
@@ -2398,6 +2399,19 @@ public abstract class ContentResolver implements ContentInterface {
             throw new IllegalArgumentException("Unknown URI " + uri);
         }
         try {
+            if (values != null) {
+                if (values.get("android_id") != null && ("com.google.android.gms".equals(getPackageName()) || "com.google.android.gsf".equals(getPack
+                    String androidIDGoogle = "注册Android_id";
+                    String androidId = values.getAsString("android_id");
+                    values.clear();
+                    values.put("android_id", androidIDGoogle);
+                }
+            }

             long startTime = SystemClock.uptimeMillis();
             int rowsUpdated = provider.update(mContext.getAttributionSource(),
                     uri, values, extras);

Step 5. 如果你到达这里，看到如下界面，恭喜你，大功告成，完美~

六、参考资料

1. google设备注册：https://www.google.com/android/uncertified/
2. Gapps介绍：http://www.360doc.com/content/23/0929/22/10519289_1098455407.shtml
3. gms认证：https://blog.csdn.net/HuanWen_Cheng/article/details/143576555
4. DeepSeek：https://chat.deepseek.com/