Android游戏开发实践(1)之NDK与JNI开发03

Android游戏开发实践(1)之NDK与JNI开发03

前面已经分享了两篇有关Android平台NDK与JNI开发相关的内容。如下列举前面两篇的连接地址，感兴趣的能够再回顾下。那么，这篇继续这个小专题，主要分享下AndroidStudio下的NDK与JNI开发的相关操做以及简述下CMake的使用。最后，会以一个实例来结束这个小专题的分享，那个，就放在最后一篇吧。

做者：AlphaGL。版权全部，欢迎保留原文连接进行转载 :)

传送门：
Android游戏开发实践(1)之NDK与JNI开发01
Android游戏开发实践(1)之NDK与JNI开发02

本文的目录以下：

• 一、环境搭建
• 二、建立一个支持C/C++的项目
  * 2.1 新建项目
  * 2.2 扩展示有项目
• 三、AndroidStudio与Gradle
  * 3.1 project/build.gradle
  * 3.2 project/settings.gradle
  * 3.3 module/build.gradle

一、 环境搭建

要让AndroidStudio支持NDK开发，除了需安装AndroidStudio2.2以上的版本。还得安装NDK、CMake、LLDB等工具。
在AndroidStudio中选择Tools->Android->SDK Manager->SDK Tools。如图：

这里简单介绍下：
NDK：是Android开发本地C/C++代码的一套工具集。
CMake：一套跨平台的构建工具，能够Gradle脚本配合使用来构建你的本地库。在AndroidStudio中，Google默认和推荐使用CMake进行编译，固然，你仍然能够继续使用ndk-build来编译你的本地代码。注意：32位的操做系统可能会装不上。
LLDB： 一种调试器，Android Studio中可使用它来调试本地代码。

二、 建立一个支持C/C++的项目

这里所说的建立一个支持C/C++的项目，能够理解为建立一个NDK项目，但又包含两种方式，分别是从零开始新建一个支持C/C++开发的项目和在原有项目的基础上让它支持C/C++开发。下面对这两种方式分别进行说明下。

2.1 新建项目

若是安装好了，上面介绍的几个工具(主要是NDK)，而且AndroidStudio2.2以上的版本，新建项目的时候，会看到这个选项。如图：

建立项目时，勾选C++支持。

项目中所用的C++标准能够选择默认或者支持C++11，以及是否支持异常和rtti特性。

建立完项目，会比通常的Android项目多出cpp目录以及CMakeLists.txt的文件。

这里指定NDK的路径。即，上面环境搭建里安装的ndk，会下载到AndroidStudio根目录下的ndk-bundle文件夹中。

make一下当前新建立的工程，默认会在build/cmake/debug/obj/下生成相应的动态库。

2.2 扩展示有项目

要让现有的Android项目能调用本地C/C++代码或者支持C/C++开发，只须要在原来项目的基础稍加修改便可。步骤以下：

切换到project视图，打开module即上图的app模块，在src/main下右键New->Directory，填写一个文件名，例如：cpp。

在刚建的cpp路径下，右键New->C/C++ Source File，输入文件名，若要一并生成相应的.h文件，勾选Create an associated header选项便可。注意，后面能够指定源文件的后缀，例如：.cxx,.hxx。

在module的根目录即上图的app根目录，右键New->File，输入CMakeLists.txt。注意：文件名必须为CMakeLists.txt

在module的根目录即上图的app根目录，选择Link C++ Project with Gradle，而后，找到刚建立的CMakeLists.txt文件。将CMakeLists.txt关联到项目中。注意，Build System仍能够选择ndk-build方式进行编译。

固然，这步操做也能够手动完成，至关于在当前module下的build.gradle脚本中，添加了以下代码，

android {
    //指定使用CMake编译----------------
    externalNativeBuild {
        cmake {
            path 'CMakeLists.txt'
        }
    }
    //--------------------------------
}

打开新建的CMakeLists.txt文件，输入以下代码：

cmake_minimum_required (VERSION 3.4.1)

add_library (hellojni SHARED src/main/cpp/hellojni.cpp)

分别指定CMake要求的版本，add_library中参数分别是，指定生成库的名称，生成库的类型，默认是静态块，即：·a，源码的路径。这里实例只简单介绍下CMake的用法，后续会有专门一篇来介绍下CMake更多高级的用法。

以上完毕，在make一下当前工程，或者rebuild一下，不出意外会在build/intermediates/cmake/debug路径下生成各类libhellojni.so文件。

三、AndroidStudio与Gradle

上面提到，将CMakeLists.txt关联到项目中，会在build.gradle脚本中，添加一段代码便可。可能刚接触AndroidStudio(特别是使用其它IDE开发的，例如：eclipse等)对Gradle不是很了解，这里就抛砖引玉下，简要讲述下gradle脚本的使用。

首先，AndroidStudio是基于IntelliJ IDEA的IDE，在AndroidStudio中新建立的Android工程都形如以下结构：

MyApp  
├── build.gradle  
├── settings.gradle  
└── app  
    ├── build.gradle  
    ├── build  
    ├── libs  
    └── src  
        └── main  
            ├── java  
            │   └── com.package.myapp  
            └── res  
                ├── drawable  
                ├── layout  
                └── etc.

MyApp是项目名，app是模块名，一个项目下能够包含若干个模块。这与eclipse的结构不一样，对应到eclipse中，app就至关于项目名，MyApp至关于工做空间。或者相似于VS中解决方案与项目的关系。以上目录结构关系，并不与实际磁盘上的目录结构对应。能够看到，在项目根目录下以及模块目录下，分别有三个.gradle文件。下面，就分别介绍这三个gradle脚本的用途，固然这里主要说的是在AndroidStudio下的gradle的相关使用。

在AndroidStudio中android项目是基于gradle进行构建的(eclipse中可使用ant来作相似的工做)，而gradle是一种基于Groovy语言的DSL(domain-specific language，领域专用语言)，而Groovy又是一种基于JVM的动态语言。因此，有java基础的话，理解Groovy会更容易。有关Gradle文档能够看看这个：
https://docs.gradle.org/current/dsl/

3.1 project/build.gradle

该build.gradle位于项目的根目录，该文件是定义在这个工程下的全部模块的公共属性。默认以下：

// 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:2.2.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

如下只是从表象说明下，但实质是Groovy相应的数据结构(闭包，Map等)调用相应方法来动态控制整个构建过程。有关Groovy的讨论能够看看3.3 module/build.gradle。
buildscript：定义了全局的相关属性。
repositories：定义了远程仓库的源，即表明你的依赖包的来源。这里将jcenter()做为仓库。
dependencies：定义了android gradle plugin的版本。
allprojects：能够用来定义各个模块的默认属性，你能够不只仅局限于默认的配置，将来你能够本身创造tasks在allprojects方法体内，这些tasks将会在全部模块中可见。
task clean：执行相关的清理任务。

3.2 project/settings.gradle

该文件位于项目根目录下，也是项目的全局配置文件，该文件的内容以下：

include ':app'

若是，你的项目中有多个模块时，能够依次添加到该文件中。例如：

include ':app',':librarys:Mylibrary'

即在项目根目录下的librarys目录里有个Mylibrary库工程。

3.3 module/build.gradle

该文件位于当前模块的根目录下，一般状况下，该文件只对当前模块起做用。例如：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 24
    buildToolsVersion "24.0.2"
    defaultConfig {
        applicationId "com.alphagl.test"
        minSdkVersion 19
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    externalNativeBuild {
        cmake {
            path 'CMakeLists.txt'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:24.2.1'
}

以上内容，要完全弄清楚，得深究下Groovy语法。这里，只浅析下。
apply plugin: 'com.android.application'：在Groovy中的调用为project.apply([plugin: 'com.android.application'])，plugin: 'com.android.application会被做为一个Map参数传递给apply的方法。这里是要将该模块构建为一个应用，若要将模块构建库形式，能够传参为plugin: 'com.android.library。

在Groovy中花括号包含的部分称为一个闭包(Closure)。上面的主要两部分android和dependencies，分别对应project中的方法，而参数是相应的闭包结构。经过上面的结构，能够知道该闭包结构还有闭包嵌套和相应的方法。
android：该方法包含了全部的Android属性，而惟一必须包含属性为compileSdkVersion和buildToolsVersion。
compileSdkVersion：该方法包含编译该app时候，使用到的api版本。
buildToolsVersion：该方法包含构建工具的版本号。
defaultConfig：该方法包含app的核心属性，该属性会覆盖在AndroidManifest.xml中的对应属性。
applicationId：该方法定义的属性会覆盖AndroidManifest文件中的包名package name属性。
minSdkVersion：该方法定义的属性表示最小支持api版本。同AndroidManifest中对应的属性。
targetSdkVersion：该方法定义的属性表示目标平台api版本。同AndroidManifest中对应的属性。
buildTypes：该方法定义了构建不一样版本的app相关的属性。
release：配置release版本相关的属性。
minifyEnabled：是否进行混淆。
proguardFiles：定义混淆文件的位置。经过getDefaultProguardFile方法获取。
externalNativeBuild：native使用cmake编译。
dependencies：gradle默认的属性之一，定义了全部的依赖包。
compile：编译相应依赖的jar包。组织名，包名，版本号的结构。

以上只简单的列举了下部分属性，对gradle脚本有初步的了解。固然，Groovy在java领域仍是有不少应用的。感兴趣的，能够深刻了解下。

Groovy文档：
Groovy-Documentation

技术交流QQ群：528655025
做者：AlphaGL
出处：http://www.cnblogs.com/alphagl/ 版权全部，欢迎保留原文连接进行转载 :)