mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-12-14 15:59:01 +08:00
55be137d5b
* Android: add docs/examples/vcpkg_android_example_cmake/ * Add docs/users/android.md * Improve Android prefab doc Following additional informations given by @atkawa7 at https://github.com/microsoft/vcpkg/pull/11264 * Link to android.md * Update the prefab usage instructions: "vcpkg install" the 4 archs before exporting a prefab * added --prefab-debug flag * added gradle integration info * reviewed the prefab output directory structure (from a dump of an actual export) * docs/users/triplets.md: link to android.md * docs/index.md: link to android.md * android.md: specify 2 possibiities for android_ndk_home * Added examples/vcpkg_android_example_cmake_script/cmake/vcpkg_android.cmake Usage: 1. Main CMakeLists: if (VCPKG_TARGET_ANDROID) include("cmake/vcpkg_android.cmake") endif() 2. cmake invocation: cmake .. -DVCPKG_TARGET_ANDROID=ON -DANDROID_ABI=armeabi-v7a * trigger pipeline build * trigger pipelines
159 lines
5.3 KiB
Markdown
159 lines
5.3 KiB
Markdown
# Vcpkg: export Android prefab Archives (AAR files)
|
|
|
|
Vcpkg can export android archives ([AAR files](https://developer.android.com/studio/projects/android-library)). Once an archive is created, it can imported in Android Studio as a native dependent. The archive is automatically consumed using [android studio's prefab tool](https://github.com/google/prefab).
|
|
|
|
For more information on Prefab, refer to:
|
|
* The [official prefab documentation](https://google.github.io/prefab).
|
|
* a blog post from Android developers blog: [Native Dependencies in Android Studio 4.0](https://android-developers.googleblog.com/2020/02/native-dependencies-in-android-studio-40.html)
|
|
|
|
_Note for Android Studio users: prefab packages are supported on Android Studio 4+_
|
|
|
|
## Requirements
|
|
|
|
1. `ndk <required>`
|
|
|
|
Set environment variable `ANDROID_NDK_HOME` to your android ndk installation. For example:
|
|
|
|
````
|
|
export ANDROID_NDK_HOME=/home/your-account/Android/Sdk/ndk-bundle
|
|
````
|
|
|
|
2. `7zip <required on windows>` or `zip <required on linux>`
|
|
|
|
3. `maven <optional>`
|
|
|
|
4. Android triplets
|
|
|
|
See [android.md](../users/android.md) for instructions on how to install the triplets.
|
|
|
|
*Please note that in order to use "prefab" (see below), the four architectures are required. If any is missing the export will fail*
|
|
|
|
|
|
## Example exporting [jsoncpp]
|
|
|
|
First "vcpkg install" the 4 android architectures (it is mandatory to export all 4 of them)
|
|
|
|
````
|
|
./vcpkg install jsoncpp:arm-android jsoncpp:arm64-android jsoncpp:x64-android jsoncpp:x86-android
|
|
````
|
|
|
|
|
|
Then, export the prefab:
|
|
|
|
Note:
|
|
* The `--prefab-maven` flag is optional. Call it if you maven is installed.
|
|
* The `--prefab-debug` flag will output instructions on how to use the prefab archive via gradle.
|
|
|
|
```
|
|
./vcpkg export --triplet x64-android jsoncpp --prefab --prefab-maven --prefab-debug
|
|
```
|
|
|
|
You will see an ouput like this:
|
|
```
|
|
The following packages are already built and will be exported:
|
|
jsoncpp:arm64-android
|
|
|
|
Exporting package jsoncpp...
|
|
[DEBUG] Found 4 triplets
|
|
arm64-android
|
|
x64-android
|
|
x86-android
|
|
arm-android
|
|
|
|
...
|
|
... Lots of output...
|
|
...
|
|
|
|
[INFO] Scanning for projects...
|
|
Downloading from central: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/2.5/maven-clean-plugin-2.5.pom
|
|
|
|
...
|
|
... Lots of output...
|
|
...
|
|
|
|
[INFO] BUILD SUCCESS
|
|
[INFO] Total time: 2.207 s
|
|
[INFO] Finished at: 2020-05-10T14:42:28+02:00
|
|
|
|
|
|
...
|
|
... Lots of output...
|
|
...
|
|
|
|
[DEBUG] Configuration properties in Android Studio
|
|
In app/build.gradle
|
|
|
|
com.vcpkg.ndk.support:jsoncpp:1.9.2
|
|
|
|
And cmake flags
|
|
|
|
externalNativeBuild {
|
|
cmake {
|
|
arguments '-DANDROID_STL=c++_shared'
|
|
cppFlags "-std=c++17"
|
|
}
|
|
}
|
|
|
|
In gradle.properties
|
|
|
|
android.enablePrefab=true
|
|
android.enableParallelJsonGen=false
|
|
android.prefabVersion=${prefab.version}
|
|
|
|
Successfuly exported jsoncpp. Checkout .../vcpkg/prefab
|
|
|
|
```
|
|
|
|
#### The output directory after export
|
|
|
|
````
|
|
prefab
|
|
└── jsoncpp/
|
|
├── aar/
|
|
│ ├── AndroidManifest.xml
|
|
│ ├── META-INF/
|
|
│ │ └── LICENSE
|
|
│ └── prefab/
|
|
│ ├── modules/
|
|
│ │ └── jsoncpp/
|
|
│ │ ├── libs/
|
|
│ │ │ ├── android.arm64-v8a/
|
|
│ │ │ │ ├── abi.json
|
|
│ │ │ │ ├── include/
|
|
│ │ │ │ │ └── json/
|
|
│ │ │ │ │ ├── json.h
|
|
│ │ │ │ │ └── ....
|
|
│ │ │ │ └── libjsoncpp.so
|
|
│ │ │ ├── android.armeabi-v7a/
|
|
│ │ │ │ ├── abi.json
|
|
│ │ │ │ ├── include/
|
|
│ │ │ │ │ └── json/
|
|
│ │ │ │ │ ├── json.h
|
|
│ │ │ │ │ └── ....
|
|
│ │ │ │ └── libjsoncpp.so
|
|
│ │ │ ├── android.x86/
|
|
│ │ │ │ ├── abi.json
|
|
│ │ │ │ ├── include/
|
|
│ │ │ │ │ └── json/
|
|
│ │ │ │ │ ├── json.h
|
|
│ │ │ │ │ └── ....
|
|
│ │ │ │ └── libjsoncpp.so
|
|
│ │ │ └── android.x86_64/
|
|
│ │ │ ├── abi.json
|
|
│ │ │ ├── include/
|
|
│ │ │ │ └── json/
|
|
│ │ │ │ │ ├── json.h
|
|
│ │ │ │ │ └── ....
|
|
│ │ │ └── libjsoncpp.so
|
|
│ │ └── module.json
|
|
│ └── prefab.json
|
|
├── jsoncpp-1.9.2.aar
|
|
└── pom.xml
|
|
````
|
|
|
|
## Example consuming [jsoncpp] via vcpkg and prefab
|
|
|
|
See the example repo here:
|
|
|
|
https://github.com/atkawa7/prefab-vpkg-integration-sample
|