first commit

This commit is contained in:
魏风
2026-05-01 10:06:36 +08:00
commit e29d75e367
129 changed files with 1485 additions and 0 deletions

View File

@@ -0,0 +1,256 @@
# 1.2.3 Fast Pair Validator 环境搭建 {#fast-pair-validator-环境搭建}
:::: {.Section1}
`<style type="text/css">/**/
div.rbtoc1777598906641 {padding: 0px;}
div.rbtoc1777598906641 ul {margin-left: 0px;}
div.rbtoc1777598906641 li {margin-left: 0px;padding-left: 0px;}
/**/</style>`{=html}
::: {.toc-macro .rbtoc1777598906641}
- [1 搭建手机端的测试环境](#id-1.2.3FastPairValidator环境搭建-1搭建手机端的测试环境)
- [1.1 手机需要连接google网络](#id-1.2.3FastPairValidator环境搭建-1.1手机需要连接google网络)
- [1.2 手机不可以打开勿扰模式,不然可能看不到弹窗](#id-1.2.3FastPairValidator环境搭建-1.2手机不可以打开勿扰模式,不然可能看不到弹窗)
- [1.3 检查手机是否打开Google Play服务通知](#id-1.2.3FastPairValidator环境搭建-1.3检查手机是否打开GooglePlay服务通知)
- [1.4 检查google play 服务是否更新到最新的版本](#id-1.2.3FastPairValidator环境搭建-1.4检查googleplay服务是否更新到最新的版本)
- [1.5 登陆google账号](#id-1.2.3FastPairValidator环境搭建-1.5登陆google账号)
- [1.6 打开自动同步数据功能](#id-1.2.3FastPairValidator环境搭建-1.6打开自动同步数据功能)
- [1.7 检查Show notification是否打开](#id-1.2.3FastPairValidator环境搭建-1.7检查Shownotification是否打开)
- [1.8 Setting界面打开蓝牙以及位置信息。](#id-1.2.3FastPairValidator环境搭建-1.8Setting界面打开蓝牙,以及位置信息。)
- [1.9 Enable debug mode ID](#id-1.2.3FastPairValidator环境搭建-1.9EnabledebugmodeID)
- [1.10 Check Google Play Service version](#id-1.2.3FastPairValidator环境搭建-1.10CheckGooglePlayServiceversion)
- [1.11 注册成为google beta tester内部测试账号已经注册过了这一步不需要如果是客户自己注册的Google账号需要提醒客户check](#id-1.2.3FastPairValidator环境搭建-1.11注册成为googlebetatester内部测试账号已经注册过了这一步不需要如果是客户自己注册的Google账号需要提醒客户check)
- [2 Fast Pair Validator APP安装](#id-1.2.3FastPairValidator环境搭建-2FastPairValidatorAPP安装)
- [3 Enable fast pair validator app中的测项](#id-1.2.3FastPairValidator环境搭建-3Enablefastpairvalidatorapp中的测项)
- [3.1 安装adb:](#id-1.2.3FastPairValidator环境搭建-3.1安装adb:)
- [3.2 输入如下命令:](#id-1.2.3FastPairValidator环境搭建-3.2输入如下命令:)
- [4 uninstall amazon 相关app](#id-1.2.3FastPairValidator环境搭建-4uninstallamazon相关app)
- [5 测试账号和MODEL ID](#id-1.2.3FastPairValidator环境搭建-5测试账号和MODELID)
- [6 测试准备](#id-1.2.3FastPairValidator环境搭建-6测试准备)
:::
### 1 搭建手机端的测试环境 {#id-1.2.3FastPairValidator环境搭建-1搭建手机端的测试环境}
测试手机建议使用Google pixel手机请**务必确保**手机端有打开开发者选项 [https://developer.android.com/studio/debug/dev-options?hl=zh-cn](https://developer.android.com/studio/debug/dev-options?hl=zh-cn){.external-link rel="nofollow"} 
\
#### 1.1 手机需要连接google网络 {#id-1.2.3FastPairValidator环境搭建-1.1手机需要连接google网络}
该网络必须可以登陆google的网站在测试前请先测试一下是否可以登录google的网站(**建议试试能不能打开youtube之类的**)。
#### 1.2 手机不可以打开勿扰模式,不然可能看不到弹窗 {#id-1.2.3FastPairValidator环境搭建-1.2手机不可以打开勿扰模式,不然可能看不到弹窗}
![](media/1.2.3+Fast+Pair+Validator+环境搭建/94667834a280a4a9bbc13db5dbc554fc.png)
#### 1.3 检查手机是否打开Google Play服务通知 {#id-1.2.3FastPairValidator环境搭建-1.3检查手机是否打开GooglePlay服务通知}
Setting-\>(Apps&notification  or   Apps)应用和通知-\> See all apps -\>Google Play服务-\>通知-\>All Google Play services notifications, 开启(显示通知)
![](media/1.2.3+Fast+Pair+Validator+环境搭建/1e4f2c79976f21a9e067e2b7f94dc4d5.png)
#### 1.4 检查google play 服务是否更新到最新的版本 {#id-1.2.3FastPairValidator环境搭建-1.4检查googleplay服务是否更新到最新的版本}
setting-\>(Apps&notification    or   Apps)应用和通知-\>See all apps-\>Google Play 服务-\>高级-\>商店, 点击 App details or google play界面会跳转到google play 商店,点击更新.
如果已经成为 beta tester, google play service可能会自动更新到最新的。
![](media/1.2.3+Fast+Pair+Validator+环境搭建/f2fdc69e7658e7f5955988ca5f9280d5.png)
![](media/1.2.3+Fast+Pair+Validator+环境搭建/7313649e14e054046dc31eafc26a99a0.png)
\
#### 1.5 登陆google账号 {#id-1.2.3FastPairValidator环境搭建-1.5登陆google账号}
Settings\>Accounts   or  Seetings-\>Google(内部账号(不可给客户)
[[[[[Fast Pair Validator 测试 请使用 ]{style="color: rgb(0,0,0);"}]{style="color: rgb(23,43,77);"}]{style="color: rgb(255,0,0);"}]{style="color: rgb(0,0,0);"}]{style="color: rgb(255,0,0);"}[realsilbt8888@gmail.com](mailto:realsilbt8888@gmail.com){.external-link rel="nofollow"}[   ]{style="color: rgb(255,0,0);"}
[手动测试账号请参考 [[Google 账号 - BT_Market - WIKI (realtek.com)](https://wiki.realtek.com/pages/viewpage.action?pageId=394285307){rel="nofollow"} ]{style="color: rgb(23,43,77);"}]{style="color: rgb(255,0,0);"}
#### 1.6 打开自动同步数据功能 {#id-1.2.3FastPairValidator环境搭建-1.6打开自动同步数据功能}
由于GFPS的account key是存在google账号的云端的所以必须要登陆google账号并且需要打开自动同步数据功能
Settings\>Accounts
![](media/1.2.3+Fast+Pair+Validator+环境搭建/0b8ab45807f00be2a354fdb1f6568f26.png)
or
Seetings→Google:
![](media/1.2.3+Fast+Pair+Validator+环境搭建/824e58e4157c13a7a9ae26740fdc94fa.png)![](media/1.2.3+Fast+Pair+Validator+环境搭建/c53346bd740285ec3eff9a183d840538.png)![](media/1.2.3+Fast+Pair+Validator+环境搭建/8ec23fa1fcbeed94cd2fd9578f0002e5.png)![](media/1.2.3+Fast+Pair+Validator+环境搭建/9623d91573182c7f5b1493f12c4356e3.png)
#### 1.7 检查Show notification是否打开 {#id-1.2.3FastPairValidator环境搭建-1.7检查Shownotification是否打开}
Settings\>Google\>(Devices & sharing)\>Devices(设置\>Google\>设备连接\>设备\>)
pixel 2xl:
![](media/1.2.3+Fast+Pair+Validator+环境搭建/4e9dd6bc92d127639a4e5a538c9acc42.png)
pixel 7:
![](media/1.2.3+Fast+Pair+Validator+环境搭建/ebec7d388fb86d05aca3ba2165f5098e.png)![](media/1.2.3+Fast+Pair+Validator+环境搭建/80eb0310afca33931827d2287ded6836.png)
\
跑 Fast pair validator 测试之前关掉 Automatically save devices
**Note: 只有realsilbt8888的账号需要关掉 Automatically save devices 其他手动测试的账号Automatically save devices需要打开**
![](media/1.2.3+Fast+Pair+Validator+环境搭建/bb062e88ef90abe40f8398b64950b341.png)
#### 1.8 Setting界面打开蓝牙以及位置信息。 {#id-1.2.3FastPairValidator环境搭建-1.8Setting界面打开蓝牙,以及位置信息。}
\
#### 1.9 Enable debug mode ID {#id-1.2.3FastPairValidator环境搭建-1.9EnabledebugmodeID}
The model ID provided to you is a debug mode ID. To enable it, go to Settings \> Google \> Devices & sharing \> Devices \> top right 3 dot menu to enable "Include debug results".
If the option "Include debug results" is missing in this page, please ensure Developer options in the phone is enabled.
or go to Settings \> Google \> Devices & sharing \> Devices \>"Include debug results" 
Settings \> Google \> Devices & sharing \> Devices \> top right 3 dot menu to enable "Include debug results"
![](media/1.2.3+Fast+Pair+Validator+环境搭建/3f2cbf0fb83aedb623ce6a6af44aede9.png)
or
Settings \> Google \> Devices & sharing \> Devices \>"Include debug results"
![](media/1.2.3+Fast+Pair+Validator+环境搭建/3843e586b6e1f94639186b0584b86176.png)
[https://developer.android.com/studio/debug/dev-options?hl=zh-cn](https://developer.android.com/studio/debug/dev-options?hl=zh-cn){.external-link rel="nofollow"}
#### 1.10 Check Google Play Service version {#id-1.2.3FastPairValidator环境搭建-1.10CheckGooglePlayServiceversion}
Purpose: To confirm we use right version of Fast Pair module for testing
Go to Settings \> Apps&notification  or Apps\>google play services \> advanced,  then check Google Play services version (It should be 20.XX.XX or higher).
![](media/1.2.3+Fast+Pair+Validator+环境搭建/eb0dd21fa08cde04a9b83381d4884e1e.png)
\
\
#### **1.11 注册成为google beta tester内部测试账号已经注册过了这一步不需要如果是客户自己注册的Google账号需要提醒客户check** {#id-1.2.3FastPairValidator环境搭建-1.11注册成为googlebetatester内部测试账号已经注册过了这一步不需要如果是客户自己注册的Google账号需要提醒客户check}
Sign up for the Google Play services beta program [https://play.google.com/apps/testing/com.google.android.gms](https://play.google.com/apps/testing/com.google.android.gms){.external-link rel="nofollow"}
join the Android Beta group at [https://www.google.com/android/beta](https://www.google.com/android/beta){.external-link rel="nofollow"} to get latest update via OTA
Finder/Find Hub testing program please Navigate to [https://play.google.com/apps/testing/com.google.android.apps.adm](https://play.google.com/apps/testing/com.google.android.apps.adm){.external-link rel="nofollow"}
\
可以登陆Google账号之后在以下链接查看是否有添加成功[我的群组](https://groups.google.com/my-groups){.external-link rel="nofollow"}
![](media/1.2.3+Fast+Pair+Validator+环境搭建/6e51bd1141ca846e4af0bb2e93e17334.png)
需要注意的是:
![](media/1.2.3+Fast+Pair+Validator+环境搭建/0bab20060f6b2f3bfb155b88a05828b1.png)
如果没有权限添加FAE需要联系YingTsung (YT) Lin 请他发邮件给Google 让Google把客户注册的Google账号添加到Google的Test group。
\
### **2 Fast Pair Validator APP安装** {#id-1.2.3FastPairValidator环境搭建-2FastPairValidatorAPP安装}
确认手机是否安装 Fast Pair Validator APP
Fast pair validator app 图标如下图:
[![](media/1.2.3+Fast+Pair+Validator+环境搭建/0ba213fcc09099ab41c8e0221e4928f5.png)]{style="color: rgb(153,51,0);"}
如果没有安装:
去 Play Store/应用商店 下载 Fast Pair Validator APP并且安装。
如果已经安装:
确认安装的是否是最新版。不是最新版,请手动升级到最新版。确认步骤如下:
长按 Fast Pair Validator 图标会看到App info
![](media/1.2.3+Fast+Pair+Validator+环境搭建/bbdfcb16c991936618508c182350d221.png)
点击App info,会看到App details
![](media/1.2.3+Fast+Pair+Validator+环境搭建/c1a5e093b0c30a6ec18f3a502923afd7.png)
点击App details,会看到以下页面如果有新版本请手动更新到最新的版本。如果是beta版本则不需要更新系统会自动帮忙更新。
![](media/1.2.3+Fast+Pair+Validator+环境搭建/6f2e8db9a220e705bf4d48b3aaf9c482.png)
### 3 Enable fast pair validator app中的测项 {#id-1.2.3FastPairValidator环境搭建-3Enablefastpairvalidatorapp中的测项}
#### [3.1 安装adb:]{style="color: rgb(32,33,36);"} {#id-1.2.3FastPairValidator环境搭建-3.1安装adb:}
[[adb安装及使用方法](https://wiki.realtek.com/pages/viewpage.action?pageId=87464469){rel="nofollow"} 该wiki上提供的adb版本太旧会出现device offline的问题下载最新的[https://adbshell.com/downloads](https://adbshell.com/downloads){.external-link rel="nofollow"}]{style="color: rgb(32,33,36);"}
安装adb之后找到adb.exe所在的目录在该目录下打开cmd命令行
#### 3.2 输入如下命令: {#id-1.2.3FastPairValidator环境搭建-3.2输入如下命令:}
adb shell am broadcast -a com.google.location.nearby.apps.fastpair.validator.FLAG_OVERRIDE \--es flag enable_features_for_v3 \--es value true \--es type boolean com.google.location.nearby.apps.fastpair.validator
[![](media/1.2.3+Fast+Pair+Validator+环境搭建/5040df7f9e4af787dd63c45576f1d7f2.png)]{.confluence-embedded-file-wrapper .confluence-embedded-manual-size}
按enter执行命令。
命令执行成功之后,
打开fast pair validator 能看到新的feature
\
### 4 uninstall amazon 相关app {#id-1.2.3FastPairValidator环境搭建-4uninstallamazon相关app}
Alexa (com.amazon.dee.app) 和com.amazon.wellness app 会影响到Validator的测试需要Uninstall。
The Alexa (com.amazon.dee.app) took too much time on handling the ACL_CONNECTED intent, which impacts the Validator\'s flow.
There is still another **app,com.amazon.wellness** app, who handled ACL_CONNECTED for 20+ seconds.Please uninstall it as well.
现象 End-to-end integration测试出现Pairing timeout
操作方式: 
adb uninstall com.amazon.wellness
adb uninstall com.amazon.dee.app
\
### 5 测试账号和MODEL ID {#id-1.2.3FastPairValidator环境搭建-5测试账号和MODELID}
使用Fast Pair Validator测试需要先登陆Google账号测试设备使用的Model ID,public key, private key 必须是该google账号注册的Device。
场内测试账号:[realsilbt8888@gmail.com](mailto:realsilbt8888@gmail.com){.external-link rel="nofollow"}
**Note**
fast pair validator app使用的model id 要和DUT开发板配置的model id一致。
![](media/1.2.3+Fast+Pair+Validator+环境搭建/940b91547f4e49233ceaaf7092386c29.png)![](media/1.2.3+Fast+Pair+Validator+环境搭建/389cce5910af360b6867f26f36c1b9a3.png)
### **6 测试准备** {#id-1.2.3FastPairValidator环境搭建-6测试准备}
测试过程中需要注意
手机端弹出配对提示框时不要手动点击fast pair validator app会自己触发配对.
开始测试前,需要确认是否已经和待测试耳机配对过,需要删除配对信息。 最后最好在开始测试前,开关一下飞行模式。
点击GOT IT开始测试时耳机端一定要处于Pairable mode否则会scan不到设备, scan 到设备后点击Test开始测试。
![](media/1.2.3+Fast+Pair+Validator+环境搭建/6fa8e8c938098fc1362ca8cadcd5f68f.png)
::::