GMS 要求

#GMS 要求

该文档列举了android合作设备与google移动服务正确整合的要求。要求按如下类型进行分组：

• 分发GMS 组件：定义在哪些情况下，什么GMS 组件必须被分发
• 启动品牌：定义在启动过程中设备应展示的内容
• 设备安装体验：首次设置设备时，定义UX 要求
• 主屏幕外观：定义设置完成后，GMS组件必须最初呈现给用户的方式
• 安全要求：定义设备上必须包含哪些安全功能
• 设置要求：定义设置应用程序的行为
• 平台功能要求：定义在什么情况下，哪些平台功能必须被提供。

基本要求

• 当装配一个带GMS设备时，请注意如下基本要求：
• 装配GMS的android设备必须符合*安卓兼容定义文档（CDD）*并且必须通过诸如：CTS，CTS Verifier ，GTS等测试套件。
• 每个装配GMS的Android设备必须有三个物理上分离的按钮，用于BACK，HOME，RECENT功能
• 每个新装配GMS的Android设备必须符合”GMS批准窗口“要求。谷歌仅支持在GMS批准窗口打开的情况下，在API 级别发布的新产品。一旦产品获得批准并发布，无论GMS批准窗口是否打开，其维护版本（MR）构建和安全维护版本（SMR）构建都可以被批准。
• 在任何情况下，GMS的二进制内容都不能被修改
• 在最新的GMS bundle 中，新设备启动必须预加载所有核心的应用程序和服务，最新是指bundle应不晚于谷歌发布最新包的60天内。然而，如果谷歌发布了一个更新版本的独立核心组件，只要这个构建符合这个文档，合作者就可以预加载它而不是GMS bundle中的那个。这个要求也符合维护版本（MR）的建立，但是谷歌可以予以放弃。
• 在安全维护版本（MR）构建中，合作者不应该包含任何GMS更新以确保更小的增量更新大小，除非一个GMS模块必须更新为符合构建声明的安全补丁级别。

#分发GMS组件

##地理位置可用性（Geo-availability）
GMS包含的每个谷歌产品都有一个相应的 ”地理位置可用性“ 定义。它概述了在给定国家中安卓上谷歌产品的可用性。随着谷歌在新的国家发布产品，Geo-availability 的定义也随着时间而改变。最新的geo-avaiablility可从GMS帮助中心获取。
**
注：**在俄罗斯联邦销售或分销的GMS智能手机必须满足GMS Russia Build 要求。
所有装配GMS的设备必须符合geo-availability。例如，如果一个设备将在一个国家销售，它必须根据geo-availability定义中的规定条件来预加载适用于该国家的一系列应用程序。
##核心应用程序和服务
GMS核心应用程序和服务包括下面启动图标所要求的应用程序以及常用的服务，如WebView（呈现Web网页和在线内容），数据同步服务（用于日历，联系人，邮件和其他应用），配置管理和设置，用于内容回放的数字化，文本转语音和其他应用服务。
###核心服务
下表列出了Android6.0或更高版本的所有GMS核心服务。

apk文件名 / 软件包名	描述
ConfigUpdater com.google.android.configupdater	允许无线更新不可执行的系统组件
GmsCore com.google.android.gms	为第三方应用提供谷歌服务
GoogleBackupTransport com.google.android.backuptransport	将数据备份到用户的谷歌帐号
GoogleFeedback com.google.android.feedback	允许用户向谷歌发送错误报告和反馈GoogleLoginService
GoogleLoginService com.google.android.gsf.login	谷歌帐号认证服务 注：Android 8.0后不再需要，包括升级的设备
GoogleOneTimeInitializer com.google.android.onetimeinitializer	第一次启动时的一次性初始化
GooglePartnerSetup com.google.android.partnersetup	合作伙伴专用设备初始化服务
GoogleServicesFramework com.google.android.gsf	远程服务供应框架
SetupWizard com.google.android.setupwizard	开箱即用的用户体验
GoogleCalendarSyncAdapter com.google.android.syncadapters.calendar	同步日历数据到用户的谷歌帐号 注：如果预加载了独立的谷歌日历应用，则可以将其移除
GoogleContactsSyncAdapter com.google.android.syncadapters.contacts	同步联系人数据到用户的谷歌帐号
WebViewGoogle com.google.android.webview	网页渲染器
GoogleTTS com.google.android.tts	文本转语音的无障碍服务
GooglePackageInstaller com.google.android.packageinstaller	提供运行时权限用户界面 注：只有Android 6.0及以上版本才需要
GoogleExtServices com.google.android.ext.services	提供安卓框架扩展机制 注：只有Android 7.0及以上版本才需要
GoogleExtShared com.google.android.ext.shared	同上** 注：只有Android 7.0及以上版本才需要**
GooglePrintRecommendationService com.google.android.printservice.recommendation	允许用户发现喝配置本地网络的打印机** 注：只有Android 7.0及以上版本才需要**

Jar包名	描述
com.google.android.maps.jar com.google.android.media.effects.jar	必须预加载这些jar包文件 以支持Android SDK 中的 “Google APIs”组件。例如：Android 7.0这个组件下载在${ANDROID_HOME}/add-ons/addon-google_apis-google-24目录下。

核心应用（取决于geo-availability）

注： Duo仅适用于电话设备。 非电话设备必须预加载Hangouts。

• Google Play 商店
• 谷歌搜索
• Chrome浏览器
• 谷歌云端硬盘
• Gmail
• Google Duo
• 地图
• Google Play Music
• 谷歌照片
• 谷歌Play电影
• YouTube

##可选应用
合作者可分发在在geo-availabbility表列出的可选GMS应用程序。如果这些应用只是提供一些功能，谷歌推荐预加载它们。否则，除了诸如新兴市场这些稀缺数据，谷歌推荐通过 Play Auto Installs 将这些应用分发给最终用户。如果你想预加载一个表中未列出的谷歌应用，请联系你的技术客户经理。
##Play Auto Installs
通过 Play Auto Installs （PAI）合作伙伴可以在第一次运行时，开箱即用体验，出厂重置后或者在谷歌帐号添加时自动安装Play商店发布的应用到最终用户设备。PAI可以让用户选择卸载应用并恢复内存空间。推荐原始设备制造商使用PAI分发可选GMS应用，OEM，运营商和第三方应用。

有关Play Auto Installs更多信息，请点击这里。

##启动审批窗口

为了确保将来对于用户来说，GMS功能的一致性和适用性，截至至2014年2月，谷歌只允许GMS在发布在新平台的新安卓设备上分发。

明确来说，谷歌将不再允许发布旧API级别的新产品（由build.PRODUCT定义），旧API是指GMS审批窗口已关闭该API级别。对于已在partner.android.com中获得批准的现有产品，谷歌仍将批准新的维护版本（MR）构建。这允许合作伙伴向之前装配设备的android用户提供更新的安全补丁和重要的错误修复。

GMS发布的审批窗口：

API 版本	AOSP 发布日期	批准窗口
4.1 and earlier		2014-02-01
4.2 (API Level 17)	2012-11-13	2014-04-24
4.3 (API Level 18)	2013-07-24	2014-07-31
4.4 (API Level 19)	2013-10-31	2015-06-30
5.0 (API level 21)	2014-11-03	2015-10-30
5.1 (API level 22)	2015-05-09	2016-06-30
6.0 (API level 23)	2015-10-05	2017-01-31
7.0 (API level 24)	2016-08-22	2018-05-31
7.1 (API level 25)	2016-10-04	2018-05-31
8.0 (API level 26)	2017-08-21	将于2019年Q1发布

为了帮助合作者满足审批时限，我们通过平台开发包（PDK）和其他软件发行版来提供对即将发行的平台软件以及通过https://partner.android.com/eap提供的其他资源（指南文档，cdd摘要等）的早期访问。

#启动品牌

"Powered by Android"启动动画序列（和品牌标记）是为了确定操作android系统的设备质量，这些产品经过全球认证并销售给消费者。它将根据发布在Android Partner Toolkit网站中的指南展示在启动序列中。

https://support.google.com/androidpartners_gms/answer/7351400

#设备安装体验
为了在安卓设备上有更好的安装体验，谷歌SetupWizard提供了一个参考实现。建议使用谷歌安装想到原样。但是，只要满足如下要求，合作伙伴可以修改或定制安装体验。
更多关于安装向导流程要求和可用自定义的细节发布在GMS Help Center

• 强烈建议在设置其他需要网络连接的设备功能之前允许用户设置WI-FI连接。
• 在网络连接之后展示给用户的第一个帐号设置必须是谷歌帐号设置。
• 在设备设置期间展示给用户的帐号设置（谷歌或其他）必须提供一个用户选项以跳过该设置。
• 如果没有出厂重置保护权限或在认证为出厂重置保护权限一部分之前，用户不能以任何方式离开设置向导。
• 在离开设置向导之前用户必须有机会在谷歌服务屏幕上看到谷歌相关的条款和条件以及隐私同意书。
• 所有手持设备必须支持设备所有者设置
  • 报告android.hardware.nfc的设备必须启用基于NFC冲突的提供。（AOSP包含一个参考实现）
  • 带有相机的Android 7.0及更新版本设备必须支持QR码所有者设置。
• Android 7.0或更高版本设备必须使用向导管理器来自定义设置体验。不再支持使用AccountManager.addAccount() API来创建一个完全的自定义设置向导。GTS测试将在未来测试安装向导流程。

#主屏幕外观
##默认的主屏幕布局
默认的主屏幕就是一个设备默认的展示，在最终用户进行任何更改之前，当设备处于活跃的空闲模式，在横屏或竖屏模式没有产生滚动时出现。该屏必须与按下物理home按键或者点击导航栏上的home按键显示的屏幕相同。

默认的主屏幕必须具备一下特点：

1. 谷歌搜索控件
2. 包含核心GMS应用图标的Google Collection文件夹
3. Play Store 应用图标
   
   默认主屏幕的示例布局

###谷歌搜索控件的放置
为了提供一致的用户体验，谷歌搜索小部件是通过谷歌搜索应用提供的小部件，谷歌搜索应用包含在核心的GMS中。
**注：**在一个设备中预加载的默认启动器禁止自定义谷歌搜索小控件。例如，在AOSP中的启动器2提供了一个硬编码搜索小控件，但是他不符合GMS要求。推荐合作伙伴预加载在AOSP中实现的Launcher3。

###Google Colections 文件夹的放置
在主屏幕中的文件夹必须：

• 标有“Google”
• 按照如下顺序从左到右，从上到下排序核心GMS应用图标（视地理位置而定）。
  1. Google Search

2. Chrome
3. Gmail
4. Maps
5. YouTube
6. Drive
7. Play Music
8. Play Movies
9. Duo (or Hangouts if non-telephony device)
10. Photos

• 不包含任何非Google应用
  
  Google Collections 文件夹外观
  ###在hotseat或默认主屏幕中应用程序的放置
  任何GMS应用可以被放置在hotseat或默认主屏幕。如果核心应用图标被放在hotseat或默认主屏幕，那么它们可以从Google收藏中移除。

##可选GMS应用的放置
可选应用图标应该采取如下一个放置：

• 默认主屏幕的一个图标;
• hotseat;
• 在google文件夹，在收藏夹的末尾（即在照片应用后面）;
• 在预先批准的Play/Create文件夹里

Play / Create 文件夹

以下附加文件夹预先批准在主屏幕上使用：

• Play 包含Play Music, Play Movies, Play Games, Play Books, and Play Newsstand.
• Create 包含Docs, Sheets, Slides（幻灯片）, Drive, and Keep (可选).
  其他应用不可以放在这些文件夹里。
  如果配置了Play或Create文件夹，相应的应用图标必须从谷歌收藏夹中移除（例如：Play Music ，Play Movies， 和Drive）
  任何备用文件夹集合，如果包含了任何GMS应用，必须被谷歌批准。
  

在应用菜单上的放置

在应用菜单上放置GMS应用要遵循下列要求：

• 所有的GMS应用必须放置在应用菜单上
• 如果OEM选择在应用程序菜单中实现文件夹，则核心应用程序图标应该放置在谷歌文件夹。如上所述：其他预批准文件夹是Play和Create文件夹。
• Play商店应该位于应用菜单的顶层，并且不应该驻留应用菜单的任何文件夹中。
• 其他应用图标（如在Android 5.1或更早版本的谷歌设置）可以放在谷歌文件夹中或在应用菜单的顶层。

#安全要求
##安全补丁
对于那些每个Android 6.0或更高版本的软件构建（包括新的或维护版本MR构建），必须有所有安全补丁。（此处待翻译）
##Google Play Protect
在GMS设备上，Google Play商店应用必须行驶包验证功能，允许Google Play Store功能保护用户远离有害应用。

#设置要求

谷歌设置

从Android6.0以后,