android NDK JNI so文件的制作和使用

参考:

java jni 入门1 - 一个简单的从Java程序中调用C函数 : http://blog.csdn.net/u012005313/article/details/49644283



#########################################################


之前也接触过NDK和JNI,但是并没有很好的结合NDK和JNI来总结关于so文件的制作和使用。现在把最近一段时间的接触的关于so的制作和使用总结一下。


还是从最简单的例子开始:android apk调用一个C函数,输出一个log记录,并返回一个字符串“Hello JNI”


##############################################################3


新建一个工程SoDemo



后面一直选择Next/Finish即可完成新建工程



修改activity_main.xml代码如下:

[html] view plain copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     xmlns:tools="http://schemas.android.com/tools"  
  4.     android:layout_width="match_parent"  
  5.     android:layout_height="match_parent"  
  6.     android:paddingBottom="@dimen/activity_vertical_margin"  
  7.     android:paddingLeft="@dimen/activity_horizontal_margin"  
  8.     android:paddingRight="@dimen/activity_horizontal_margin"  
  9.     android:paddingTop="@dimen/activity_vertical_margin"  
  10.     tools:context="com.zj.sodemo.MainActivity">  
  11.   
  12.     <TextView  
  13.         android:id="@+id/text"  
  14.         android:layout_width="match_parent"  
  15.         android:layout_height="wrap_content"  
  16.         android:textAlignment="center"  
  17.         android:text="Hello World!"  
  18.         android:layout_alignParentTop="true"  
  19.         />  
  20.   
  21.     <Button  
  22.         android:id="@+id/button"  
  23.         android:layout_width="match_parent"  
  24.         android:layout_height="wrap_content"  
  25.         android:text="click me"  
  26.         android:layout_alignParentBottom="true"  
  27.         />  
  28. </RelativeLayout>  

功能介绍:加入一个文本框和按钮。apk运行后,点击按钮调用C程序,文本框显示返回的字符串


修改MainActivity.java代码如下:

[java] view plain copy
  1. package com.zj.sodemo;  
  2.   
  3. import android.app.Activity;  
  4. import android.support.v7.app.AppCompatActivity;  
  5. import android.os.Bundle;  
  6. import android.view.View;  
  7. import android.widget.Button;  
  8. import android.widget.TextView;  
  9.   
  10. public class MainActivity extends Activity {  
  11.   
  12.     private Button mButton;  
  13.     private TextView mTextView;  
  14.       
  15.     private String text = null;  
  16.   
  17.     static {  
  18.         System.loadLibrary("JNITest");  
  19.     }  
  20.       
  21.     public native String helloJNI();  
  22.   
  23.     @Override  
  24.     protected void onCreate(Bundle savedInstanceState) {  
  25.         super.onCreate(savedInstanceState);  
  26.         setContentView(R.layout.activity_main);  
  27.   
  28.         mButton = (Button)findViewById(R.id.button);  
  29.         mTextView = (TextView)findViewById(R.id.text);  
  30.   
  31.         mButton.setOnClickListener(new View.OnClickListener() {  
  32.             @Override  
  33.             public void onClick(View view) {  
  34.                 text = helloJNI();  
  35.                 mTextView.setText(text);  
  36.             }  
  37.         });  
  38.     }  
  39. }  
功能介绍:新建文本框和按钮,同时调用so库JNITest,调用so库里面的函数是helloJNI,同时为按钮建立一个点击监听器,点击按钮,则调用helloJNI()函数,并显示返回的字符串。


至此,前期准备工作都已完成

##########################################################3


接下来需要使用JDK工具javah来建立java和C/C++之间的联系

参考文档: Android Studio & NDK: I got an error when “javah -d jni -classpath…” - http://stackoverflow.com/questions/27252712/android-studio-ndk-i-got-an-error-when-javah-d-jni-classpath


在  android ndk 入门 - 一个简单的ndk工程 : http://blog.csdn.net/u012005313/article/details/49911693 中,已经介绍了如何在android studio中配置javah

下面,我介绍一种使用命令行的方式

首先你需要先生成MainActivity.java的class文件,点击菜单栏build->Make Project(快捷键Ctrl + F9)即可编译整个工程。编译完成后,在路径app/build/intermediates/classes/debug/com/zj/sodemo下应该会出现MainActivity.class文件


android studio配置了控制台窗口,在窗口底部工具栏中应该有Terminal选项


如果不存在,则点击顶部菜单栏View->Tool Windows->Terminal(快捷键Ctrl + F12)就会弹出控制台窗口


进入main目录并新建文件夹jni

[plain] view plain copy
  1. cd app/src/main/  
  2. mkdir jni  


运行以下命令:

[plain] view plain copy
  1. javah -d jni -classpath /opt/android-sdk-linux/platforms/android-24/android.jar:../../build/intermediates/classes/debug/ com.zj.sodemo.MainActivity  
命令介绍:-d参数-输出目录

-classpath-从中加载类的路径。没有配置android.jar环境变量的话就需要在这里加入(注意,android.jar后面跟的是一个冒号:,而不是分号;

com.zj.sodemo.MainActivity是生成JNI样式的表头文件

在这里我们将生成的.h文件保存在jni文件夹内:


打开文件com_zj_sodemo_MainActivity.h:

  1. /* DO NOT EDIT THIS FILE - it is machine generated */  
  2. #include <jni.h>  
  3. /* Header for class com_zj_sodemo_MainActivity */  
  4.   
  5. #ifndef _Included_com_zj_sodemo_MainActivity  
  6. #define _Included_com_zj_sodemo_MainActivity  
  7. #ifdef __cplusplus  
  8. extern "C" {  
  9. #endif  
  10. #undef com_zj_sodemo_MainActivity_BIND_ABOVE_CLIENT  
  11. #define com_zj_sodemo_MainActivity_BIND_ABOVE_CLIENT 8L  
  12. #undef com_zj_sodemo_MainActivity_BIND_ADJUST_WITH_ACTIVITY  
  13. #define com_zj_sodemo_MainActivity_BIND_ADJUST_WITH_ACTIVITY 128L  
  14. #undef com_zj_sodemo_MainActivity_BIND_ALLOW_OOM_MANAGEMENT  
  15. #define com_zj_sodemo_MainActivity_BIND_ALLOW_OOM_MANAGEMENT 16L  
  16. #undef com_zj_sodemo_MainActivity_BIND_AUTO_CREATE  
  17. #define com_zj_sodemo_MainActivity_BIND_AUTO_CREATE 1L  
  18. #undef com_zj_sodemo_MainActivity_BIND_DEBUG_UNBIND  
  19. #define com_zj_sodemo_MainActivity_BIND_DEBUG_UNBIND 2L  
  20. #undef com_zj_sodemo_MainActivity_BIND_EXTERNAL_SERVICE  
  21. #define com_zj_sodemo_MainActivity_BIND_EXTERNAL_SERVICE -2147483648L  
  22. #undef com_zj_sodemo_MainActivity_BIND_IMPORTANT  
  23. #define com_zj_sodemo_MainActivity_BIND_IMPORTANT 64L  
  24. #undef com_zj_sodemo_MainActivity_BIND_NOT_FOREGROUND  
  25. #define com_zj_sodemo_MainActivity_BIND_NOT_FOREGROUND 4L  
  26. #undef com_zj_sodemo_MainActivity_BIND_WAIVE_PRIORITY  
  27. #define com_zj_sodemo_MainActivity_BIND_WAIVE_PRIORITY 32L  
  28. #undef com_zj_sodemo_MainActivity_CONTEXT_IGNORE_SECURITY  
  29. #define com_zj_sodemo_MainActivity_CONTEXT_IGNORE_SECURITY 2L  
  30. #undef com_zj_sodemo_MainActivity_CONTEXT_INCLUDE_CODE  
  31. #define com_zj_sodemo_MainActivity_CONTEXT_INCLUDE_CODE 1L  
  32. #undef com_zj_sodemo_MainActivity_CONTEXT_RESTRICTED  
  33. #define com_zj_sodemo_MainActivity_CONTEXT_RESTRICTED 4L  
  34. #undef com_zj_sodemo_MainActivity_MODE_APPEND  
  35. #define com_zj_sodemo_MainActivity_MODE_APPEND 32768L  
  36. #undef com_zj_sodemo_MainActivity_MODE_ENABLE_WRITE_AHEAD_LOGGING  
  37. #define com_zj_sodemo_MainActivity_MODE_ENABLE_WRITE_AHEAD_LOGGING 8L  
  38. #undef com_zj_sodemo_MainActivity_MODE_MULTI_PROCESS  
  39. #define com_zj_sodemo_MainActivity_MODE_MULTI_PROCESS 4L  
  40. #undef com_zj_sodemo_MainActivity_MODE_NO_LOCALIZED_COLLATORS  
  41. #define com_zj_sodemo_MainActivity_MODE_NO_LOCALIZED_COLLATORS 16L  
  42. #undef com_zj_sodemo_MainActivity_MODE_PRIVATE  
  43. #define com_zj_sodemo_MainActivity_MODE_PRIVATE 0L  
  44. #undef com_zj_sodemo_MainActivity_MODE_WORLD_READABLE  
  45. #define com_zj_sodemo_MainActivity_MODE_WORLD_READABLE 1L  
  46. #undef com_zj_sodemo_MainActivity_MODE_WORLD_WRITEABLE  
  47. #define com_zj_sodemo_MainActivity_MODE_WORLD_WRITEABLE 2L  
  48. #undef com_zj_sodemo_MainActivity_DEFAULT_KEYS_DIALER  
  49. #define com_zj_sodemo_MainActivity_DEFAULT_KEYS_DIALER 1L  
  50. #undef com_zj_sodemo_MainActivity_DEFAULT_KEYS_DISABLE  
  51. #define com_zj_sodemo_MainActivity_DEFAULT_KEYS_DISABLE 0L  
  52. #undef com_zj_sodemo_MainActivity_DEFAULT_KEYS_SEARCH_GLOBAL  
  53. #define com_zj_sodemo_MainActivity_DEFAULT_KEYS_SEARCH_GLOBAL 4L  
  54. #undef com_zj_sodemo_MainActivity_DEFAULT_KEYS_SEARCH_LOCAL  
  55. #define com_zj_sodemo_MainActivity_DEFAULT_KEYS_SEARCH_LOCAL 3L  
  56. #undef com_zj_sodemo_MainActivity_DEFAULT_KEYS_SHORTCUT  
  57. #define com_zj_sodemo_MainActivity_DEFAULT_KEYS_SHORTCUT 2L  
  58. #undef com_zj_sodemo_MainActivity_RESULT_CANCELED  
  59. #define com_zj_sodemo_MainActivity_RESULT_CANCELED 0L  
  60. #undef com_zj_sodemo_MainActivity_RESULT_FIRST_USER  
  61. #define com_zj_sodemo_MainActivity_RESULT_FIRST_USER 1L  
  62. #undef com_zj_sodemo_MainActivity_RESULT_OK  
  63. #define com_zj_sodemo_MainActivity_RESULT_OK -1L  
  64. /* 
  65.  * Class:     com_zj_sodemo_MainActivity 
  66.  * Method:    helloJNI 
  67.  * Signature: ()Ljava/lang/String; 
  68.  */  
  69. JNIEXPORT jstring JNICALL Java_com_zj_sodemo_MainActivity_helloJNI  
  70.   (JNIEnv *, jobject);  
  71.   
  72. #ifdef __cplusplus  
  73. }  
  74. #endif  
  75. #endif  


里面有函数声明JNIEXPORT jstring JNICALL Java_com_zj_sodemo_MainActivity_helloJNI

接下来就是实现该函数声明


#############################################3

生成.h文件后我们就可以编写相应的C/C++实现代码


在jni目录下新建main.cpp,代码如下:

  1. #include <iostream>  
  2. #include <jni.h>  
  3. #include <android/log.h>  
  4. #include "com_zj_sodemo_MainActivity.h"  
  5. using namespace std;  
  6.   
  7. #define LOG_TAG "zj"  
  8. #define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)  
  9.   
  10. extern "C"  
  11. {  
  12.   
  13. /* 
  14.  * Class:     com_zj_sodemo_MainActivity 
  15.  * Method:    helloJNI 
  16.  * Signature: ()Ljava/lang/String; 
  17.  */  
  18. JNIEXPORT jstring JNICALL Java_com_zj_sodemo_MainActivity_helloJNI  
  19.   (JNIEnv *env, jobject obj)  
  20.   {  
  21.     LOGI("now in jni world");  
  22.   
  23.     return env->NewStringUTF("Hello JNI");  
  24.   }  
  25.   
  26. }  

程序介绍:

1.生成so文件需要头文件jni.h;

2.输出log需要头文件android/log.h;

3.需要包含头文件com_zj_sodemo_MainActivity.h并实现其中声明的函数

4.如果使用C++代码,则必须实现本地方法的声明extern "C"(阻止C++编译器生产C++特有的代码)

5.JNICALL Java_com_zj_sodemo_MainActivity_helloJNI定义中实现了一条记录的输出,并返回一个字符串


#################################################


参考:

android studio 使用 jni 编译 opencv 完整实例 之 图像边缘检测!从此在andrid中自由使用 图像匹配、识别、检测 - http://www.cnblogs.com/linguanh/p/4624768.html?utm_source=tuicool&utm_medium=referral

android ndk 入门之打印log信息 - http://blog.csdn.net/qiuxiaolong007/article/details/7548580


接下来就是生成so库


在目录jni中新建Android.mk:

  1. LOCAL_PATH := $(call my-dir)  
  2. include $(CLEAR_VARS)  
  3.   
  4. LOCAL_MODULE := JNITest  
  5. LOCAL_SRC_FILES := main.cpp  
  6. LOCAL_LDLIBS +=-L$(SYSROOT)/usr/lib -lm -llog  
  7. include $(BUILD_SHARED_LIBRARY)  

新建Application.mk:

  1. APP_STL := gnustl_static  
  2. APP_CPPFLAGS := -frtti -fexceptions  
  3. APP_ABI := armeabi-v7a       #这句是设置生成的cpu指令类型,提示,目前绝大部分安卓手机支持armeabi,libs下太多类型,编译进去 apk 包会过大  
  4. APP_PLATFORM := android-8    #这句是设置最低安卓平台,可以不弄  

打开android stdio的控制台窗口,进入jni路径,运行命令ndk-build:



运行成功,同时生成so库libJNITest.so,位于目录libs/armeabi-v7a中:



###############################


有两种方式使用so库。

1.android studio默认调用src/main/jniLibs下的so文件;

2.通过配置,可以使用src/main/libs下的so文件


我们现在实现第2种。打开app/build.gradle文件,在android{}内加入:

[plain] view plain copy
  1. sourceSets {  
  2.     main() {  
  3.         jniLibs.srcDirs = ['src/main/libs']  
  4.         jni.srcDirs = []  
  5.     }  
  6. }  

同时,在gradle.properties文件中加入语句:

[plain] view plain copy
  1. android.useDeprecatedNdk=true  

编译整个工程:点击顶部菜单栏Build->Make Project

编译完成后点击运行按钮(Run 'app',快捷键Shift + F10)




点击按钮




發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章