Firefox 应用程序服务

应用程序服务 (a-s) 是一组Rust组件，用于使Firefox应用程序能够与Firefox账户、同步、实验等功能集成。每个组件都是使用Rust编写的共享代码核心构建的，并使用不同平台的本地语言绑定进行包装。

贡献

要贡献，请查阅Mozilla的 社区参与指南，然后访问我们的 如何贡献 指南。

联系

在Matrix或其他GitHub问题中与其他社区成员取得联系。

• Matrix: #rust-components:mozilla.org (如何连接)

文档

高级文档

《应用服务书籍》包含了关于此存储库中代码的高级文档。它由./docs/目录构建。

包文档

我们使用rustdoc来记录组件的公共API和各种内部实现细节。您可以在https://mozilla.github.io/application-services/book/rust-docs/fxa_client/index.html上查看它们。一旦您完成了构建步骤，您可以通过运行以下命令查看文档：

cargo doc --no-deps --document-private-items --open

构建

构建Rust组件

1. 克隆或下载存储库

  $ git clone https://github.com/mozilla/application-services # (or use the ssh link)
  $ cd application-services
  $ git submodule init
  $ git submodule update --recursive

2. 按照以下说明安装您的系统级依赖项
3. 运行a-s Rust单元测试

cargo test

消费者构建、集成和测试

application-services库的主要消费者是Fenix（Android上的Firefox）和Firefox iOS。请确保您能够通过遵循构建Android和iOS集成的说明来运行集成测试（如果使用MacOS）。

Android集成构建和有用工具

• 构建说明以测试Fenix / android-components集成
• android-components和application-services的Fenix自动发布工作流程

Firefox for iOS集成

• 构建说明以测试Firefox iOS集成

Firefox桌面

• 构建说明以测试Firefox桌面集成

Rust组件

./components/包含每个组件的源代码。请注意，大多数组件都有由uniffi库生成的FFI。

• 请参阅./components/places/的示例，其中您可以找到
  • 共享的Rust代码。
  • Android应用程序使用的Kotlin绑定。
  • 用于iOS应用程序的Swift绑定。
• 请参阅./components/fxa-client的示例，该示例使用uniffi为Kotlin和Swift等多种语言生成API包装器。

组件列表

• autofill - 用于存储和同步信用卡和地址信息
• crashtest - 测试目的（使Rust代码崩溃）
• fxa-client - 用于需要使用FxA进行登录、访问同步加密密钥等的应用程序。
• logins - 用于存储和同步用户的已保存登录凭据
• nimbus - 用于与Firefox的Mozilla的实验平台集成
• places - 用于存储和同步用户的已保存浏览历史记录
• push - 用于应用程序通过WebPush接收实时更新
• support - 低级实用库
  • support/rc_crypto - 处理由Mozilla的NSS库支持的加密需求
  • support/sql - 使用SQL存储本地数据的实用程序
• sync15 - 访问Firefox Sync中数据的共享库
• sync_manager - 将多个同步引擎/存储集成到单个框架中
• tabs - 用于远程浏览器标签的内存同步引擎
• viaduct - HTTP请求库
• webext-storage - 为chrome.storage.sync WebExtension API的实现提供动力

注意以上列表不完整；请参阅“components”目录下的实际列表。