原创

Android Studio之NDK环境搭建,so文件打包以及使用

关于ndk,jni的介绍请自行谷歌、百度。推荐查看网友的ndk系列文章,写的较为详细,深入 Android NDK开发 (该系列教程开发环境为win + Eclipse)

本篇入门教程开发环境为mac + Android Studio + gradle 2.14.1,主要包含以下3块内容:

  • NDK环境搭建
  • 编写第一个JNI项目
  • 打包出动态so文件,在其他项目中使用

一、NDK环境搭建

  1. 从Android Studio安装(自行翻墙)
    打开AndroidStudio,选择顶部工具条,Tools->Android->SDK Manager->SDK Tools->NDK 点击install
  2. 自行下载ndk包

    1)国内推荐通过 AndroidDevTools镜像 下载,或者Google的官方网站下载Android NDK的安装包 https://developer.android.com/ndk/downloads/index.html

    Android Studio之NDK环境搭建,so文件打包以及使用

    NDK r13b

    2)下载ndk包后解析到某个路径,打开Project Structure->设置 NDK location

    Android Studio之NDK环境搭建,so文件打包以及使用

    AndroidDevTools 下载

  3. ndk环境变量配置,我们需要使用到ndk-build命令
    打开终端 -> 输入 :vim ~/.bash_profile -> 加入ndk 包的路径(mac中环境变量之间以封号隔开)

自此,ndk开发环境我们已经可以进行jni开发了

二、JNI开发

  1. 创建android项目
  2. 查看项目local.properties中加入ndk和sdk的路径是否正确
    ndk.dir=/Users/userName/AndroidStudioProjects/ndk/android-ndk-r13b
    sdk.dir=/Users/userName/Library/Android/sdk
  3. 配置项目下的gradle.properties文件,表示我们要使用NDK进行开发。
    android.useDeprecatedNdk=true
  4. 在moudle根目录下的的build.gradle中的defaultConfig标签内部里加入如下代码
    ndk{    
    moduleName "hello"       //生成的so文件名字,调用C程序的代码中会用到该名字    
    abiFilters "armeabi", "armeabi-v7a", "x86" //输出指定三种平台下的so库,
    // 还可以添加 'x86_64', 'mips', 'mips64'
    }
  5. 编写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();
    }
  6. 生成.h头文件

    直接使用Android Studio 底部的Terminal,默认命令行窗口路径已经在当前项目,进入到app/src/main/java目录,输入以下命令(固定格式:javah -jni 包名+类名)

    javah -jni com.david.ndktest.MainActivity

    为在对应包的根目录下生成.h文件,熟悉该函数名后,日常开发中可以不用生成.h文件

    Android Studio之NDK环境搭建,so文件打包以及使用

    生成头文件

  7. 执行第5部的时候,对应native会提示找不到对应方法,快捷键 alt+enter 会生成对应jni文件夹,包含libName.c文件,此处MainActivity中的native方法还是会显示红色,但是不影响编译

    Android Studio之NDK环境搭建,so文件打包以及使用

    生成.c文件

  8. 编译项目后会发现app/build中已经生成so文件,并且已经对应的cpu包就是我们在gradle中已经配置的,并且已经调用成功

    Android Studio之NDK环境搭建,so文件打包以及使用

    build中生成对应so文件

    Android Studio之NDK环境搭建,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
    Android Studio之NDK环境搭建,so文件打包以及使用

    building so文件

Android Studio之NDK环境搭建,so文件打包以及使用

main根目录下生成lib,obj目录

  • 其他项目中使用该so文件
    • 拷贝so文件到项目的main/jniLibs目录
    • ==新建package,包名与类名以及方法名必须与生成so文件的类保持一致!==
    • 使用方法与第二部一致,需要声明loadLibrary与native方法

      Android Studio之NDK环境搭建,so文件打包以及使用

  • 调用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

 

正文到此结束
Loading...