1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
# [Android Components](../../../README.md) > Support > AppServices
A collection of helpers for integrating native Application Services' components.
## Usage
During Application initialization (typically in `Application#onCreate`), add the following line:
```kotlin
val configuration = Config(
crashReporting = CustomCrashReporter(),
logLevel = Log.Priority.WARN,
)
AppServicesInitializer.init(configuration)
```
You may also desire to initialize the networking layer with a concept-fetch implementation
separately. Although this is not part of the initialization order that is required, doing so as
soon as possible means that any code in your native layer would be able to use
the shared network stack ASAP.
```kotlin
RustHttpConfig.setClient(lazy { HttpClient() })
// To ensure emulators still work, add something similar.
if (isDebug) {
RustHttpConfig.allowEmulatorLoopback()
}
```
### Setting up the dependency
Use Gradle to download the library from [maven.mozilla.org](https://maven.mozilla.org/) ([Setup repository](../../../README.md#maven-repository)):
```Groovy
implementation "org.mozilla.components:support-appservices:{latest-version}"
```
### Rust Log
A bridge allowing log messages from Rust code to be sent to the log
system in support-base
### Rust HTTP
A bridge allowing configuration of Rust HTTP requests without directly depending
on the application services library.
This essentially wraps the rust HTTP config library so that consumers who don't
use a custom megazord don't have to depend on application-services code.
It's separate from RustLog since it's plausible users might only want to
initialize logging, and not use any app-services network functionality.
### Rust Errors
A bridge for reporting Rust errors to Sentry/Glean.
This component defines and installs an application-services `ApplicationErrorReporter` class that:
- Forwards error reports and breadcrumbs to `SentryServices`
- Reports error counts to Glean
## License
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/
|
