android_ndk_build_flags 配置,Android Studio 1.3 配置编译NDK参考文档

欧博简
2023-12-01

Requirements

Gradle 2.5 only

Android NDK r10e (if you are using NDK)

SDK with Build Tools at least version 19.0.0 and we aim to minimize the amount of changes needed for the migration process in the future. Some features may require a more recent version.

Migrating from Traditional Android Gradle Plugin

A typical Android Studio project may have a directory structure as follows. File that needs to be change is highlighted in red:

There are some significant changes in the DSL between the new plugin and the traditional one.

.

├── app/

│   ├── app.iml

│   ├── build.gradle

│   └── src/

├── build.gradle

├── gradle/

│   └── wrapper/

│       ├── gradle-wrapper.jar

│       └── gradle-wrapper.properties

├── gradle.properties

├── gradlew*

├── gradlew.bat

├── local.properties

├── MyApplication.iml

└── settings.gradle

./gradle/wrapper/gradle-wrapper.properties

The new plugin supports only gradle-2.5.

#Wed Apr 10 15:27:10 PDT 2013

distributionBase=GRADLE_USER_HOME

distributionPath=wrapper/dists

zipStoreBase=GRADLE_USER_HOME

zipStorePath=wrapper/dists

distributionUrl=https\://services.gradle.org/distributions/gradle-2.5-all.zip

./build.gradle

Classpath for the plugin is com.android.tools.build:gradle-experimental instead of com.android.tools.build:gradle.

The current version is 0.2.0.

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {

repositories {

jcenter()

}

dependencies {

classpath 'com.android.tools.build:gradle-experimental:0.2.0'

// NOTE: Do not place your application dependencies here

// in the individual module build.gradle files

}

}

allprojects {

repositories {

jcenter()

}

}

./app/build.gradle

There are significant changes to the DSL of the plugin.  We understand that many of the changes are frustrating and seem unnecessary, and our goal is to remove some of these current changes to minimize the migration process from the traditional plugin in the future.

DSL Changes:

Plugin name is com.android.model.application instead of com.android.application. Or useapply plugin: 'com.android.model.library'if you want to create an Android aar library.

Configuration is wrapped with the model { } block

Most properties require the = operator

Adding elements to a Collection should be done using the += operator.

Current DSL Limitations that will hopefully go away:

buildTypes, productFlavors and signingConfigs must be place outside of the  android { } block.

Nested options within the android { } block must be configured using the with keyword.

Properties are only set with their direct types only, with no way to accept other types and adapting them. For instance:

Properties of type File accepts only File instead of File and String objects.

minSdkVersion cannot directly receive either an integer or string (for codename).

Creating a buildType or productFlavor requires calling the create method.  Modifying an existing one such as the release and debug buildType can be done using the just the name.

The DSL for modifying variants and their tasks is very, very limited right now.

apply plugin: 'com.android.model.application'

model {

android {

compileSdkVersion = 22

buildToolsVersion = "22.0.1"

defaultConfig.with {

applicationId =  "com.example.user.myapplication"

minSdkVersion.apiLevel = 15

targetSdkVersion.apiLevel = 22

versionCode = 1

versionName = "1.0"

buildConfigFields.with {

create() {

type = "int"

name = "VALUE"

value = "1"

}

}

}

}

android.buildTypes {

release {

minifyEnabled = false

proguardFiles += file('proguard-rules.pro')

}

}

android.productFlavors {

create("flavor1") {

applicationId = ‘com.app’

}

}

// Configures source set directory.

android.sources {

main {

java {

source {

srcDir 'src'

}

}

}

}

}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.2.0'

}

Ndk Integration

The experimental plugin comes with NDK integration for creating native applications.  To use the NDK integration:

Use the SDK Manager inside Studio to download the NDK.

Set ndk.dir in local.properties or the ANDROID_NDK_HOME environment variable to the directory containing the NDK.

Add an android.ndk block to the model in build.gradle.

Known Limitations

There’s no support for NDK-only modules. The only supported project types are hybrid app projects and hybrid Library Projects.

Consumed Library project don’t impact compilation of jni code in the consuming project (ie the AAR so files are simply packaged in the APK)

No support for creating and depending on static libraries

No support for using a NDK modules like cpu_features

No support for integrating external build systems.

The build.gradle of a simple NDK application may look like this:

Vim

apply plugin: 'com.android.model.application'

model {

android {

compileSdkVersion = 22

buildToolsVersion = "22.0.1"

}

android.ndk {

moduleName = "native"

}

}

1

2

3

4

5

6

7

8

9

10

11

applyplugin:'com.android.model.application'

model{

android{

compileSdkVersion=22

buildToolsVersion="22.0.1"

}

android.ndk{

moduleName="native"

}

}

*Note that themoduleName is required.  It determines the name of the resulting native library.

By default, it will look in src/main/jni for C/C++ file.  Configure android.sources to change the source directory.

Vim

model {

android {

compileSdkVersion = 22

buildToolsVersion = "22.0.1"

}

android.ndk {

moduleName = "native"

}

android.sources {

main {

jni {

source {

srcDir 'src'

}

}

}

}

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

model{

android{

compileSdkVersion=22

buildToolsVersion="22.0.1"

}

android.ndk{

moduleName="native"

}

android.sources{

main{

jni{

source{

srcDir'src'

}

}

}

}

}

Various build options can be set within the android.ndk { } block.  For example,

Vim

model {

android {

compileSdkVersion = 22

buildToolsVersion = "22.0.1"

}

android.ndk {

// All configurations that can be changed in android.ndk.

moduleName = "native"

toolchain = "clang"

toolchainVersion = "3.5"

// Note that CFlags has a capital C, which is inconsistent with

// the naming convention of other properties. This is a

// technical limitation that will be resolved

CFlags += "-DCUSTOM_DEFINE"

cppFlags += "-DCUSTOM_DEFINE"

ldFlags += "-L/custom/lib/path"

ldLibs += "log"

stl = "stlport_static"

}

android.buildTypes {

release {

ndk.with {

debuggable = true

}

}

}

android.productFlavors {

create("arm") {

ndk.with {

// You can customize the NDK configurations for each

// productFlavors and buildTypes.

abiFilters += "armeabi-v7a"

}

}

create("fat") {

// If ndk.abiFilters is not configured, the application

// compile and package all suppported ABI.

}

}

// You can modify the NDK configuration for each variant.

components.android {

binaries.afterEach { binary ->binary.mergedNdkConfig.cppFlags.add("-DVARIANT=\"" + binary.name + "\"")}

}

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

model{

android{

compileSdkVersion=22

buildToolsVersion="22.0.1"

}

android.ndk{

//Allconfigurationsthatcanbechangedinandroid.ndk.

moduleName="native"

toolchain="clang"

toolchainVersion="3.5"

//NotethatCFlagshasacapitalC,whichisinconsistentwith

//thenamingconventionofotherproperties.Thisisa

//technicallimitationthatwillberesolved

CFlags+="-DCUSTOM_DEFINE"

cppFlags+="-DCUSTOM_DEFINE"

ldFlags+="-L/custom/lib/path"

ldLibs+="log"

stl="stlport_static"

}

android.buildTypes{

release{

ndk.with{

debuggable=true

}

}

}

android.productFlavors{

create("arm"){

ndk.with{

//YoucancustomizetheNDKconfigurationsforeach

//productFlavorsandbuildTypes.

abiFilters+="armeabi-v7a"

}

}

create("fat"){

//Ifndk.abiFiltersisnotconfigured,theapplication

//compileandpackageallsuppportedABI.

}

}

//YoucanmodifytheNDKconfigurationforeachvariant.

components.android{

binaries.afterEach{binary->binary.mergedNdkConfig.cppFlags.add("-DVARIANT=\""+binary.name+"\"")}

}

}

Samples

Additional samples can be found at https://github.com/googlesamples/android-ndk.

对于不能正常访问GitHub的,可以点击这里下载最近保存的版本。

 类似资料: