Application Services (a-s) is a collection of Rust Components that are used to enable Firefox applications to integrate with Firefox accounts, sync, experimentation, etc. Each component is built using a core of shared code written in Rust, wrapped with native language bindings for different platforms.
To contribute, please review the Mozilla Community Participation Guidelines and then visit our how to contribute guide.
Get in touch with other community members on Matrix, or through issues here on GitHub.
The Application Services Book contains high-level documentation about the code in this repository. It's built from the ./docs/ directory.
We use rustdoc to document both the public API of the components and the various internal implementation details. View them on https://mozilla.github.io/application-services/book/rust-docs/fxa_client/index.html. Once you have completed the build steps, you can view the docs by running:
cargo doc --no-deps --document-private-items --open
$ git clone https://github.com/mozilla/application-services # (or use the ssh link)
$ cd application-services
$ git submodule init
$ git submodule update --recursive
cargo test
The application-services library primary consumers are Fenix (Firefox on Android) and Firefox iOS. Assure you are able to run integration tests (for Android and iOS if using MacOS) by following the instructions to build for Android and iOS integrations.
./components/ contains the source for each component. Note that most components have their FFI generated by the uniffi library.
Note the above list is partial; see the actual list under the components
directory.