2a025916fe
* Add an IntelliJ section to gitignore * Add Android SDK sample project which exercises mentat SDK * Symlink libmentat_ffi.so in Android SDK to the generated --release files * README files for Android SDK and mentat_ffi
22 lines
1.3 KiB
Markdown
22 lines
1.3 KiB
Markdown
# Development flow for Mentat FFI
|
|
|
|
## Android SDK
|
|
Android Mentat SDK is one of two first-party consumers (the other one being iOS Mentat SDK).
|
|
|
|
Binaries produced by `cargo build ...` are symlinked from within the SDK, and a number of target-specific `libmentat_ffi.so` binaries are bundled together and distributed with the SDK.
|
|
|
|
There is a build script at `<mentat_root>/scripts/android_build.sh` which knows how to cross-compile `mentat_ffi` for various Android targets.
|
|
|
|
- `./<mentat_root>/scripts/android_build.sh` - compiles for all supported targets
|
|
- `./<mentat_root>/scripts/android_build.sh x86` - compiles for `x86`
|
|
- `./<mentat_root>/scripts/android_build.sh x86 arm` - compiles for `x86`, `arm`
|
|
|
|
General development flow while working on the Android SDK is:
|
|
- (pre) compile for all targets, if you've never done so
|
|
- make changes to `mentat_ffi` and/or `mentat`
|
|
- re-compile `mentat_ffi` binaries using `./android_build.sh x86`. During development it's faster to compile just for the target which matches your emulator, e.g. `x86`
|
|
- make corresponding changes in the Android SDK, try them out from within the bundled sample project
|
|
- since binaries are symlinked, no manual copy step is necessary for the Android SDK to pick up the changes
|
|
|
|
## iOS SDK
|
|
TODO, contribute via [issue #732](https://github.com/mozilla/mentat/issues/732).
|