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为多种语言生成API包装器，例如Kotlin和Swift。

组件列表

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

注意，上述列表是不完整的；请查看“components”目录下的实际列表。