Android

对应的官方页面地址

要求

在开始之前，您应该已经安装了推荐的工具和库。您还需要安装：

1. Visual Studio 2022

2. .NET 7（最新版） 注意：即使您使用的是 ARM 64 架构的 M1 Mac，您也可以安装所有 x64 SDK 来运行 android

3. Xamarin (Android)

4. Android SDK 33 您可以使用 Xamarin、Visual Studio 或 Android Studio 中的 SDK 管理器来安装它

确保您已安装 Android SDK 和模拟器：

1. 打开 Visual Studio

2. 点击「Tools」->「SDK Manager」（在 Android 子标题下）

3. 点击「Tools」选项卡

4. 确保已安装以下项目：

   • Android SDK 工具（至少一个版本的命令行工具）

   • Android SDK Platform-Tools

   • Android SDK 构建工具（至少一个版本）

   • Android 模拟器

5. 如果您已标记所有要安装的内容，请单击「Apply Changes」

如果您遗漏了任何内容，Visual Studio 应该都会提示您。

安卓开发设置

要设置新的虚拟 Android 设备用于调试：

1. 点击「Tools」->「Device Manager」（在 Android 子标题下）

2. 点击「New Device」

3. 设置您要模拟的设备 - 如果您不确定，您可以选择 Base Device 并保留默认设置

4. 然后，Visual Studio 将下载该设备的镜像。下载进度显示在 Android 设备管理器对话框的进度中。

5. 完成后，模拟的 Android 设备将在「Android」->「Debug」->「{设备名称}」下作为构建目标使用

M1 Mac

1. 安装并打开 Android Studio

2. 在顶部导航栏中，点击「Android Studio」->「Preferences」->「Appearance & Behavior (tab)」->「System Settings」->「Android SDK」

3. 在 SDK 平台选项卡中，确保选中「Show Package Details」复选框（位于右下角）

4. 在每一个 Android API 的下方，您会看到一系列系统镜像，选其中的 ARM 64 v8a 并等待它下载

5. 转到「View->「Tool Windows」->「Device Manager」

6. 在「Device Manager」中，使用之前下载的系统镜像创建一个设备

测试与调试

使用安卓模拟器

为了使用本地 Mac 上的 Xamarin Studio 进行调试时访问 Android 模拟器中的 localhost:<port> 资源，您需要使用 <http://10.0.2.2:<port> 配置端点地址，以访问 localhost，它被设计为映射 Android 代理。

使用服务器隧道

您可以使用一个到本地服务器的代理隧道并让您的应用程序直接连接到它，而不是配置设备或模拟器。

推送通知

Android 应用程序的默认配置是将自身注册到与 Bitwarden 的 QA Cloud 相同的环境。这意味着，如果您尝试使用生产端点调试应用程序，您将无法接收实时同步更新或无密码登录请求。

本地测试无密码

在开始测试和调试无密码登录之前，请确保本地服务器设置运行正常（服务器设置）。您还应该能够将 Android 应用程序部署到您的设备或模拟器上。

调试和测试无密码身份验证受到推送通知的限制。

测试无密码通知：

1. 启动本地服务器（Api、Identity、Notifications）

2. 确保您的移动设备可以连接到您的本地服务器

3. 启动 Web 客户端，因为您需要它来发出登录请求

4. 将 Android 应用程序部署到您的设备或模拟器

5. 部署后，打开应用程序，登录您的 QA 账户然后在设置中激活无密码登录请求

6. 使用您喜欢的浏览器打开 Web 密码库（例如：http://localhost:8080）

7. 输入之前已在该设备（即「已知设备」）上进行了身份验证的账户的电子邮件地址，然后点击「继续」。当出现登录选项时，点击「设备登录」。

8. 检查移动设备是否有通知