はじめに
xmake-gradleは、xmakeをシームレスに統合するGradleプラグインです。
現在、gradleでandroid jniの統合開発を行うには2つの方法があり、ndkBuildまたはCMakeによってサポートされています。gradleには、これら2つのツールの統合が組み込まれています
メンテナンスしかし Android.mk 特に大規模なプロジェクトのために非常に面倒まだは、より多くの痛みを伴うだろうが、cmakeのは、シンプルで直感的な十分なDSLの文法で、私は個人的に私は、クロスプラットフォーム開発を達成するために、以前のxmakeの全体を持っていないので、本当に、のように、利点があります:シンプルで高速、初心者にやさしいだけでなく、非常に強力であり、xmakeプロジェクトのホームページにアクセスして概要を確認できます。
しかし、xmakeを使用してandroid soライブラリをコンパイルする前に、次のようなコマンドラインしか使用できません。
xmake f -p android --ndk=xxxx
xmake
非常にシンプルですが、android apk / aarとパッケージ化して統合する場合でも、まだ多くの追加作業が必要です。開発者の効率を向上させるために、最近このgradleプラグインを再編成して、gradleビルド全体にシームレスに統合しましたシステム。
このようにして、ユーザーは簡単にxmakeを使用してAndroidスタジオでJNIライブラリをコンパイルし、自動統合することができます。
さらに、関連するGradle構成は基本的にcmakeおよびndkbuildと同じであり、それらのほとんどは互換性があり、スイッチングコストも大幅に削減されます。
新しくリリースされたプラグインは誰でも自由に試すことができます。詳しく知りたい場合は、次を参照してください。
準備
まず、対応するxmakeコマンドラインツールをインストールする必要があります。インストール手順については、xmakeを参照してください。
アプリケーションプラグイン
プラグインDSLによる統合
plugins {
id 'org.tboox.gradle-xmake-plugin' version '1.0.6'
}
放棄されたプラグイン統合方法
buildscript {
repositories {
maven {
url "https://plugins.gradle.org/m2/"
}
}
dependencies {
classpath 'org.tboox:gradle-xmake-plugin:1.0.6'
}
repositories {
mavenCentral()
}
}
apply plugin: "org.tboox.gradle-xmake-plugin"
構成
最も単純な構成例
xmake.lua
ファイルを追加する場合はprojectdir/jni/xmake.lua
、build.gradleで指定されたxmakeで指定された対応するJNIプロジェクトパスを有効にするだけで済みます。
build.gradle
android {
externalNativeBuild {
xmake {
path "jni/xmake.lua"
}
}
}
JNI
JNIエンジニアリング構造
projectdir
- src
- main
- java
- jni
- xmake.lua
- *.cpp
xmake.lua:
add_rules("mode.debug", "mode.release")
target("nativelib")
set_kind("shared")
add_files("nativelib.cc")
その他のGradle構成手順
android {
defaultConfig {
externalNativeBuild {
xmake {
// 追加设置全局 c 编译 flags
cFlags "-DTEST"
// 追加设置全局 c++编译 flags
cppFlags "-DTEST", "-DTEST2"
// 设置切换编译模式,与`xmake f -m debug`的配置对应,具体模式值根据自己的 xmake.lua 设置而定
buildMode "debug"
// 设置需要编译的 abi 列表,支持:armeabi, armeabi-v7a, arm64-v8a, x86, x86_64
// 如果没有设置的话,我们也支持从 defaultConfig.ndk.abiFilters 中获取 abiFilters
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
}
externalNativeBuild {
xmake {
// 设置 jni 工程中 xmake.lua 根文件路径,这是必须的,不设置就不会启用 jni 编译
path "jni/xmake.lua"
// 启用详细输出,会显示完整编译命令行参数,其他值:verbose, warning, normal
logLevel "verbose"
// 指定 c++ stl 库,默认不指定会使用 c++_static,其他值:c++_static/c++_shared, gnustl_static/gnustl_shared, stlport_static/stlport_shared
stl "c++_shared"
// 设置 xmake 可执行程序路径(通常不用设置)
// program /usr/local/bin/xmake
// 禁用 stdc++库,默认是启用的
// stdcxx false
// 设置其他指定的 ndk 目录路径 (这是可选的,默认 xmake 会自动从$ANDROID_NDK_HOME 或者`~/Library/Android/sdk/ndk-bundle`中检测)
// 当然如果用户通过`xmake g --ndk=xxx`配置了全局设置,也会自动从这个里面检测
// ndk "/Users/ruki/files/android-ndk-r20b/"
// 设置 ndk 中 sdk 版本
// sdkver 21
}
}
}
JNIをコンパイルする
JNIをコンパイルしてAPKを生成する
ときにgradle-xmake-plugin
プラグインが適用される効果を取ることです、xmakeBuild
タスクは自動的に既存の中に注入されassemble
、自動的にJNIライブラリのコンパイルおよび統合を実行するタスク。
$ ./gradlew app:assembleDebug
> Task :nativelib:xmakeConfigureForArm64
> Task :nativelib:xmakeBuildForArm64
>> xmake build
[ 50%]: ccache compiling.debug nativelib.cc
[ 75%]: linking.debug libnativelib.so
[100%]: build ok!
>> install artifacts to /Users/ruki/projects/personal/xmake-gradle/nativelib/libs/arm64-v8a
> Task :nativelib:xmakeConfigureForArmv7
> Task :nativelib:xmakeBuildForArmv7
>> xmake build
[ 50%]: ccache compiling.debug nativelib.cc
[ 75%]: linking.debug libnativelib.so
[100%]: build ok!
>> install artifacts to /Users/ruki/projects/personal/xmake-gradle/nativelib/libs/armeabi-v7a
> Task :nativelib:preBuild
> Task :nativelib:assemble
> Task :app:assembleDebug
JNIの強制再構築
$ ./gradlew nativelib:xmakeRebuild