运行于真机

为方便调试多端应用,开发者可通过连接 Android 真机 和 iOS 真机到开发电脑,再利用开发者工具安装对应的应用包到真机上。

一、在 Android 设备上运行应用

1.1 前置准备

多端应用在 Android 设备真机运行前需要完成以下前置准备:

  • Android 手机需要开启开发者选项USB 调试模式 方能自由安装开发版本的 APP(通常开启方式:在关于手机连续点击 7 次版本号,不同手机的开启方式不同,需要自行搜索)。
  • 通过 USB 数据线连接设备与电脑。

1.2 选择要运行的设备

前往工具栏,在「设备选择栏」下拉选择刷新,查看「Android 真机」是否有新的设备 id 信息,选择连接上的 Android 设备。

当选定要运行的设备之后,可在调试面板的「ANDROID - 概览」处查看所连接设备的具体信息。

  • 该功能需为 nightly 版开发者工具且版本 >= 1.06.2411282

1.3 真机运行

前往工具栏,点击「运行」,稍等片刻,等待资源包编译完成后,在设备上进行安装。

1.4 日志的查看与导出

真机运行后,我们支持在开发者工具调试面板的「ANDROID - 日志」处查看日志,同时支持点击右侧「导出」图标进行日志导出。

  • 导出功能需为 nightly 版开发者工具且版本 >= 1.06.2411272

二、在 iOS 设备上运行应用

2.1 前置准备

多端应用在 iOS 设备真机运行前需要完成以下前置准备:

  • 通过 USB 数据线将 iOS 设备连接到电脑(如果是 Mac 则可直接连接,Windows 电脑需要安装 iTunes 和 iCloud)
  • iOS 设备需开启「开发者模式」,各系统版本的开启方式不同,请自行搜索
  • 需在 Mac 上点击「允许」 iOS 设备连接到这台 Mac

2.2 选择要运行的设备

前往工具栏,在「设备选择栏」下拉选择刷新,查看「iOS 真机」是否有新的设备 id 信息,选择连接上的 iOS 设备。

2.3 真机运行与签名配置

前往工具栏,点击「运行」。如果是首次运行,则需要配置相关的签名。签名类型包括「证书签名」和「临时签名」,详细信息可查看 iOS 签名证书管理

选择「证书签名」或「临时签名」,点击「确定」后,出现的弹窗以及要配置的内容有所不同。

  • 为方便开发者更高效地生成 iOS 证书签名所需的 p12 文件以及 profile 文件,开发者工具(版本号 >= 1.06.2412042)新增支持「iOS 证书自动管理」功能,详情请查看文档 iOS 证书自动管理open in new window

若开发者工具版本号 <= 1.06.2412032,会出现以下面板配置,具体操作步骤如下文所示。

2.3.1 临时签名

点击「运行」后出现下方弹窗,并填写你的 iOS 设备对应的苹果账号和密码即可(非苹果开发者账号)。

开发者可选择是否记住账号,如果选择记住账号,则下次运行点击「运行」不再出现上述弹窗;反之,则每次点击「运行」都会出现。

  • 保存的账号密码信息只保存于本地,平台不会存储。

2.3.2 证书签名

证书签名的配置在 windows 系统和 Mac 系统上的操作有所不同,详情查看下方:

a) Mac

选择「证书签名」点击「确定」后,稍等片刻需「选择 Apple 签名证书( P12 文件)」

b) Windows
  • 选择「证书签名」点击「确定」后,稍等片刻出现弹窗和内容如下:
  • Certificate Path: p12 文件(包含私钥)
  • Certificate Password: p12 文件的密码
  • Profile: Provisioning Profile 后缀名为.mobileprovision
  • Remember: 保存在本地,下次不需要再输入

2.4 信任此开发者

按照上述步骤配置签名后,点击运行,稍等片刻则开发者工具会将对应的 App 安装至你的 iOS 设备。 首次运行 App 时,会出现「不受信任的开发者」的提示,此时,开发者可前往「设置 - 通用 - VPN 与设备管理 - 开发者 APP」配置信任,配置成功后即可正常运行。

2.5 Bundle ID 与签名类型的逻辑说明

a) Bundle ID

  • 如果当前多端应用尚未绑定移动应用账号,则默认的官方分配的测试版 Bundle ID 为 com.tencent.devtoolssaaademo.db
  • 如果当前多端应用已绑定移动应用账号,且此移动应用账号已经审核通过,则 Bundle ID 为开发者在创建移动应用账号时填写的 Bundle ID

b) Bundle ID 与签名类型

  • 当开发者选择「临时签名」时,则是以 com.tencent.devtoolssaaademo.db.***** 构建,不管当前多端应用是否绑定了移动应用账号
  • 因此,开发者需注意,当你的真机调试一直使用「临时签名」调试没问题后,在构建正式版的 IPA 用于上架 App Store 之前需使用「证书签名」的方式进行构建和调试,确保你的应用上架后的表现与你在真机测试的一致