现有Android应用Wear OS模块命名规范及错误修复问询

一、正确命名规范 #

• 模块名：建议使用wear或wearos作为模块文件夹名称，与原Android模块（如app/android）明确区分，避免目录冲突。模块名称不影响应用包名与发布逻辑，无需和原模块同名。
• 应用名：在Wear模块的strings.xml中设置带明确标识的名称，例如原应用名为「XX助手」，Wear版可设为「XX助手（Wear OS）」，方便用户识别，不要直接使用wear这类模糊名称。
• 包名：必须与原Android应用完全一致（如com.example.android）。Google Play要求配套的Wear OS应用与手机应用共用同一包名、同一签名密钥，才能作为关联应用发布，实现自动配对等功能。

二、当前错误修正方案 #

1. 解决Google Services匹配错误 #

• 先检查wear模块build.gradle中的namespace和applicationId，确认拼写为com.example.android（错误提示中的com.example.androd是拼写错误，需修正）。
• 打开项目根目录的google-services.json，确认文件内存在package_name为com.example.android的client节点。若没有，需到Google服务控制台为该包名添加Wear OS类型的客户端，重新下载google-services.json替换项目中的文件。

2. 解决模块目录重命名冲突 #

• 无需修改wear模块的文件夹名称，包名由gradle配置控制，与模块文件夹名称无关，保持wear目录即可。
• 若要调整代码包的目录结构，在Android Studio中右键点击wear模块的com.example.wear包，选择「Refactor > Rename」，将包名改为com.example.android，AS会自动处理目录层级，避免手动修改文件夹导致的冲突。

3. 解决Google Play签名与包名错误 #

• 强制使用原Android应用的签名密钥：Wear应用必须和手机应用使用同一签名（即Google Play提示的指定SHA1指纹证书），在wear模块的build.gradle中复制原模块的签名配置：

  signingConfigs {
      release {
          storeFile file("../your-keystore.jks") // 密钥库路径，可相对项目根目录
          storePassword "你的密钥库密码"
          keyAlias "你的密钥别名"
          keyPassword "你的密钥密码"
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 其他编译配置
      }
  }
  

• 确保wear模块的namespace和applicationId始终为com.example.android，Google Play仅识别同一包名、同一签名的应用为手机应用的Wear配套版本，不会再出现包名不匹配的提示。

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