xmake-gradle是什么？怎样去配置呢

简介

xmake-gradle是一个插件xmake的gradle。

准备工作

我们需要安装好安装的xmake先行工具，关于安装xmake。

应用插件

通过插件DSL集成

plugins {
id 'org.tboox.gradle-xmake-plugin' version '1.1.5'
}

被废弃的插件集成方式

buildscript {
repositories {
maven {
url
}
}
dependencies {
classpath 'org.tboox:gradle-xmake-plugin:1.1.5'
}
repositories {
mavenCentral()
}
}

apply plugin: "org.tboox.gradle-xmake-plugin"

配置

最简单的配置示例

如果将文件添加xmake.lua到projectdir/jni/xmake.lua，那么我们只需要在 build.gradle 中启用了 xmake 指定下的 JNI 工程路径即可。

构建.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"

            // 设置需要被编译的targets
            // targets "xxx", "yyy"
        }
    }
}

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
发展
编译插件
$ ./gradlew gradle-xmake-plugin:assemble
发布插件

$ ./gradlew gradle-xmake-plugin:publishPlugins

原作者：xmake-io