https://github.com/tobua/android-sdk-numic-plugin
Automatically match the native target Android SDK version with the one installed.
https://github.com/tobua/android-sdk-numic-plugin
Last synced: about 1 month ago
JSON representation
Automatically match the native target Android SDK version with the one installed.
- Host: GitHub
- URL: https://github.com/tobua/android-sdk-numic-plugin
- Owner: tobua
- Created: 2022-12-21T23:13:55.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-24T18:48:42.000Z (7 months ago)
- Last Synced: 2025-03-26T03:41:40.207Z (2 months ago)
- Language: TypeScript
- Size: 698 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# android-sdk-numic-plugin
Numic plugin to configure native folders to use the currently installed Android SDK. This ensures the build will always be successful even after updating the system.
## Installation
This plugin requires the project is managed through [numic](https://npmjs.com/numic).
```
npm i --save-dev android-sdk-numic-plugin / bun install -D android-sdk-numic-plugin
```
`buildToolsVersion`, `compileSdkVersion` and `targetSdkVersion` will be set to the newest one installed, while `minSdkVersion` will default to the React Native template unless configured explicitly. [apilevels.com](https://apilevels.com) can help in determining the appropriate `minSdkVersion` for your application. Check the [Android Version History](https://en.wikipedia.org/wiki/Android_version_history) on Wikipedia to determine the latest Android version used as `compileSdkVersion` and `targetSdkVersion`. The `buildToolsVersion` is more specific and should match the exact one you have installed. This plugin aims to be updated regularly to always point to the latest Android release. When developing it's often a good idea to try the application with the latest preview version to ensure future compatibility.
## Prerequisites
Make sure to update or install the Android SDK CLI Tools. This can be done when opening a project with Android Studio and clicking the icon "SDK Manager" on the top-right.
Furthermore, it's important to properly configure the `$ANDROID_HOME` variable. On macOS when installing Android Studio this can be set to `export ANDROID_HOME=$HOME/Library/Android/sdk` in `~/.zshrc`.
## Configuration
The detailed Android SDK versions can be configured in `package.json` under the `numic` property. This will override automatically using the installed version as described above.
```js
{
"name": "my-app",
"numic": {
"android-sdk-numic-plugin": {
"compileSdkVersion": 35,
"targetSdkVersion": 35,
"minSdkVersion": 24,
"buildToolsVersion": "35.0.0"
}
}
}
```