关于ndk,jni的介绍请自行谷歌、百度。推荐查看网友的ndk系列文章,写的较为详细,深入 Android NDK开发 (该系列教程开发环境为win + Eclipse)
本篇入门教程开发环境为mac + Android Studio + gradle 2.14.1,主要包含以下3块内容:
- NDK环境搭建
- 编写第一个JNI项目
- 打包出动态so文件,在其他项目中使用
一、NDK环境搭建
- 从Android Studio安装(自行翻墙)
打开AndroidStudio,选择顶部工具条,Tools->Android->SDK Manager->SDK Tools->NDK 点击install -
自行下载ndk包
1)国内推荐通过 AndroidDevTools镜像 下载,或者Google的官方网站下载Android NDK的安装包 https://developer.android.com/ndk/downloads/index.html
NDK r13b
2)下载ndk包后解析到某个路径,打开Project Structure->设置 NDK location
AndroidDevTools 下载
- ndk环境变量配置,我们需要使用到ndk-build命令
打开终端 -> 输入 :vim ~/.bash_profile -> 加入ndk 包的路径(mac中环境变量之间以封号隔开)
自此,ndk开发环境我们已经可以进行jni开发了
二、JNI开发
- 创建android项目
- 查看项目local.properties中加入ndk和sdk的路径是否正确
ndk.dir=/Users/userName/AndroidStudioProjects/ndk/android-ndk-r13b sdk.dir=/Users/userName/Library/Android/sdk
- 配置项目下的gradle.properties文件,表示我们要使用NDK进行开发。
android.useDeprecatedNdk=true
- 在moudle根目录下的的build.gradle中的defaultConfig标签内部里加入如下代码
ndk{ moduleName "hello" //生成的so文件名字,调用C程序的代码中会用到该名字 abiFilters "armeabi", "armeabi-v7a", "x86" //输出指定三种平台下的so库, // 还可以添加 'x86_64', 'mips', 'mips64' }
-
编写jni代码
package com.david.ndktest; - public class MainActivity extends AppCompatActivity { //使用静态代码块,表示我们要加载的资源文件为libsecret.so static { System.loadLibrary("secret"); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); TextView tv_msg = (TextView) findViewById(R.id.tv_msg); tv_msg.setText(stringFromat()); } //声明一个本地方法,用native关键字修饰 public native String stringFromat(); }
-
生成.h头文件
直接使用Android Studio 底部的Terminal,默认命令行窗口路径已经在当前项目,进入到app/src/main/java目录,输入以下命令(固定格式:javah -jni 包名+类名)
javah -jni com.david.ndktest.MainActivity
为在对应包的根目录下生成.h文件,熟悉该函数名后,日常开发中可以不用生成.h文件
生成头文件
-
执行第5部的时候,对应native会提示找不到对应方法,快捷键 alt+enter 会生成对应jni文件夹,包含libName.c文件,此处MainActivity中的native方法还是会显示红色,但是不影响编译
生成.c文件
-
编译项目后会发现app/build中已经生成so文件,并且已经对应的cpu包就是我们在gradle中已经配置的,并且已经调用成功
build中生成对应so文件
成功调用native方法
自此我们的第一个JNI项目已经编写完毕
三、打包出动态so文件,在其他项目中使用
有时候我们的需求是这样的,我们把一些比较重要的业务逻辑封装到ndk内部,对java层只暴露接口。我们就需要打包出so文件,并且可能需要在其他项目中使用,下面将介绍so(符合JNI标准)文件的打包,以及在其他项目中如何正确的调用
- 编写Android.mk文件,放到jni文件夹根目录,与.c文件同级
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := secret //lib 名
LOCAL_SRC_FILES := /
/Users/userName/AndroidStudioProjects/NdkTest/app/src/main/jni/secret.c / //.c文件名
include $(BUILD_SHARED_LIBRARY)
-
使用ndk-build命令(需要配置ndk环境变量,参照第一步第3点),生成so文件
进入到main目录后在terminal中输入命令,ndk-build工具便会帮我们打包出所有cpu平台so文件(目前不知道如何设置需要打包cpu平台)
ndk-build
building so文件
main根目录下生成lib,obj目录
- 其他项目中使用该so文件
- 拷贝so文件到项目的main/jniLibs目录
- ==新建package,包名与类名以及方法名必须与生成so文件的类保持一致!==
- 使用方法与第二部一致,需要声明loadLibrary与native方法
-
调用native方法
com.keywea.duolintest; - public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); TextView tv_msg = (TextView) findViewById(R.id.tv_msg); tv_msg.setText(com.david.ndktest.MainActivity.stringFromat()); } }
自此我们已经能够接入符合JNI标准的so库,重点在于包名,类名,方法名需要与so库保持一致,因此我们在提供so库的时候一定要记录详细的交互文档
来自:http://www.jianshu.com/p/fb29ebbf8415