Google Beacon AppIntent/FreeFormAppIntent无NearBy通知问题咨询

我来帮你一步步排查这个Google Beacon AppIntent收不到通知的问题——先从你给出的配置正确性说起，再梳理几个最容易踩的坑点：

针对你提到的包名 com.google.android.gms.nearby.messages.samples.hellobeacons 和 schema Something，核心配置规则要注意这两点：

• FreeFormAppIntent的大小写敏感：Google Nearby对schema是严格大小写敏感的，控制台里填的Something必须和你App中注册的schema完全一致，不能有大小写差异。
• AppIntent的包名精确匹配：如果是使用普通AppIntent（而非FreeForm），控制台里填写的包名必须和你实际运行的App包名完全一致——你的包名是官方示例包名，只要没在打包时修改过，这个是没问题的。

这几个是最容易导致问题的环节，按优先级逐一检查：

1. AndroidManifest中的Intent Filter配置缺失/错误
   这是绝大多数开发者踩的坑！你必须在App的AndroidManifest.xml里为目标Activity注册对应的Intent Filter，才能接收Beacon触发的Intent：

   • 如果用的是FreeFormAppIntent，要添加如下配置（注意schema和控制台完全一致）：

     <activity android:name=".YourTargetActivity"
               android:exported="true"> <!-- Android 12+必须显式设置exported -->
         <intent-filter>
             <action android:name="android.intent.action.VIEW" />
             <category android:name="android.intent.category.DEFAULT" />
             <category android:name="android.intent.category.BROWSABLE" />
             <!-- 这里的schema要和控制台里的Something完全匹配，大小写不能错 -->
             <data android:scheme="Something" />
         </intent-filter>
     </activity>
     

   • 如果是普通AppIntent，要确保目标Activity允许外部启动（android:exported="true"），否则系统会拦截Beacon触发的启动请求。

2. Nearby SDK的权限与初始化问题

   • 确认App已经申请并在运行时授予了ACCESS_FINE_LOCATION权限，Android 10+还需要ACCESS_BACKGROUND_LOCATION权限（如果App在后台也要接收通知）——Beacon检测依赖位置权限，没有权限的话根本无法检测到Beacon。
   • 检查Nearby客户端的初始化和订阅代码，确保使用了正确的策略（比如BLE Beacon要对应Strategy.BLE_ONLY）：

     // 初始化并订阅Beacon消息
     Nearby.getMessagesClient(this)
         .subscribe(mMessageListener, new SubscribeOptions.Builder()
             .setStrategy(Strategy.BLE_ONLY)
             .build());
     

3. 控制台配置的生效延迟
   Google Beacon控制台的配置修改后，需要15-30分钟才能同步到所有设备的Nearby服务，修改完不要立刻测试，等一段时间再验证。

4. Beacon设备的广播匹配问题
   确认你的Beacon正在正常广播，且广播的UUID、Major、Minor值和你在控制台中配置的Beacon ID完全一致，同时Beacon的信号强度足够（不要离测试设备过远）。

5. 测试设备的Nearby服务版本
   确保测试设备上的Google Play服务是最新版本——旧版本的Nearby服务可能存在兼容性问题，更新后再测试。

• 直接使用官方的HelloBeacons示例App测试：因为你的包名是示例包名，用示例App验证如果能收到通知，说明是你自定义App的配置问题；如果示例也收不到，那就是控制台配置或Beacon设备的问题。
• 查看Logcat日志：搜索NearbyMessages或Beacon关键词，找权限被拒、配置不匹配的报错信息，能快速定位问题根源。

内容的提问来源于stack exchange，提问作者swatz