问题背景:之前的JNI编程都是基于Android的NDK工具,生成so文件供android端调用,参见:http://blog.csdn.net/yanzi1225627/article/details/8525720 现在的目标是用eclipse CDT MinGW编写C++文件生成PC上可用的动态链接库dll,供纯Java调用。本以为很简单,可没想到折腾到半夜两点没搞定,原因是很多参考文献资料太老了。好吧,大年初一搞了两个小时终于拿下。下面是详细步骤:
准备工作:
将C:\Program Files\Java\jdk1.7.0_45\include路径下的jni.h和C:\Program Files\Java\jdk1.7.0_45\include\win32路径下的jni_md.h拷贝到MinGW下的include路径下,否则会出现找不到#include<jni.h>及不认关键字:JNIEXPORT JNICALL JNIEnv的情况。参考文献中将这两个路径直接添加到了C++工程属性里的General---Paths and Symbols---GNU C++的include栏,如下图:
而实际上是没有必要的,只需按上面的拷贝两个h文件到相应位置即可!
1、新建一个Javaproject,包名为org.yanzi.learnjni,主类为LearnJNI,即带有main函数的类。为了使代码结构有条理性,再新建一个包:org.yanzi.mylib,新建一个类JNILib.java.代码如下:
- package org.yanzi.mylib;
- public class JNILib {
- static{
- System.loadLibrary("");
- }
- public static native void jniPrint(String str);
- }
我们在这个类里将本地库加载进来,由于本地库还么有生成,所有System.loadLibrary()函数里的参数暂时不写。最关键的是下面那句话,声明了jni里的函数原型,输入一个String然后再jni里打印出来。
2、然后我们在cmd里利用javah生成与JNILib.java里jniPrint()函数相对应的JNI的声明。cmd里进到所在工程目录的src文件夹下:E:\WorkSpaces\Eclipse_Java\LearnJNI\src. 输入命令:javah org.yanzi.mylib.JNILib
注意:一定要在src文件夹下输入javah,只有这样后面的org.yanzi.mylib.JNILib(包名 + 类名)路径才能对的上。
刷新工程,就会看到生成的.h文件:
3、新建一个C++工程,如下图:
注意这个C++工程的名字就是未来生成的dll的名字libXXX.dll。这一点跟ndk不同,ndk是通过mk文件指定动态链接库的名字的。然后点击next,再新建一个src文件夹,不是必须的,仅仅是为了让程序更加规整.然后将刚才生成的org_yanzi_mylib_JNILib.h拷贝到这个src文件夹下,再新建一个cpp文件。之后这个.h文件在java工程就么有作用了,删除掉也是可以的,不过为了告诉Java调用的人接口是什么,这个h文件就要保留下。为了统一,cpp文件取名为:org_yanzi_mylib_JNILib.cpp.
原来生成的.h文件里没有形参,加形参后函数体为:
JNIEXPORT void JNICALL Java_org_yanzi_mylib_JNILib_jniPrint
(JNIEnv *env, jclass jthis, jstring str);
org_yanzi_mylib_JNILib.h文件的内容如下:
- /* DO NOT EDIT THIS FILE - it is machine generated */
- #include <jni.h>
- /* Header for class org_yanzi_mylib_JNILib */
- #ifndef _Included_org_yanzi_mylib_JNILib
- #define _Included_org_yanzi_mylib_JNILib
- #ifdef __cplusplus
- extern "C" {
- #endif
- /*
- * Class: org_yanzi_mylib_JNILib
- * Method: jniPrint
- * Signature: (Ljava/lang/String;)V
- */
- JNIEXPORT void JNICALL Java_org_yanzi_mylib_JNILib_jniPrint
- (JNIEnv *env, jclass jthis, jstring str);
- #ifdef __cplusplus
- }
- #endif
- #endif
org_yanzi_mylib_JNILib.cpp文件的内容如下:
- /*
- * org_yanzi_mylib_JNILib.cpp
- *
- * Created on: 2014-2-1
- * Author: Administrator
- */
- #include "org_yanzi_mylib_JNILib.h"
- #include <iostream>
- using namespace std;
- JNIEXPORT void JNICALL Java_org_yanzi_mylib_JNILib_jniPrint
- (JNIEnv *env, jclass jthis, jstring str){
- jboolean iscopy = false;
- const char *charData = env->GetStringUTFChars(str, &iscopy);
- cout << "Hello, this is from JNI(dll)" <<endl;
- cout<<"The data from java is:"<<charData << endl;
- env->ReleaseStringUTFChars(str, charData);
- }
[关键一步]选中工程,按alt+enter,在Build----Settings----Tool Settings-----MinGW C++ Linker目录栏下的Miscellaneous选项下,在linker flags处填入:-Wl,--add-stdcall-alias
然后点击编译,在Debug目录下生成libMyJNILib.dll,libXXX.dll名字可以发现XXX就是我们起的C++的工程名字.
4、生成dll完毕后,C++的就告一段落了。在java工程里新建一个文件夹libs,该文件夹路径跟src在同一级目录。将生成的dll拷贝到libs文件夹。
5、[关键一步]在System.loadLibrary()函数里写入参数:libMyJNILib,注意而不是MyJNILib,一定是全名,此处和ndk-build生成so不同。JNILib.java代码如下:
- package org.yanzi.mylib;
- public class JNILib {
- static{
- System.loadLibrary("libMyJNILib");
- }
- public static native void jniPrint(String str);
- }
LearnJNI.java代码如下:
- package org.yanzi.learnjni;
- import org.yanzi.mylib.JNILib;
- public class LearnJNI {
- /**
- * @param args
- */
- public static void main(String[] args) {
- // TODO Auto-generated method stub
- JNILib.jniPrint("123456");
- }
- }
此刻,点击run会报错如下,java.lang.UnsatisfiedLinkError错误:
- Exception in thread "main" java.lang.UnsatisfiedLinkError: no libMyJNILib in java.library.path
- at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1886)
- at java.lang.Runtime.loadLibrary0(Runtime.java:849)
- at java.lang.System.loadLibrary(System.java:1088)
- at org.yanzi.mylib.JNILib.<clinit>(JNILib.java:5)
- at org.yanzi.learnjni.LearnJNI.main(LearnJNI.java:12)
所以还需要下面重要一步。
6、[关键一步]选中工程,依次点击run---run configurations---LearnJNI,在点击Arguments,在Vm arguments处填入如下:-Djava.library.path="${workspace_loc}\LearnJNI\libs;${env_var:PATH}"
注意:上面这句话一点都不能错,其中LearnJNI是java的工程的名字。两头的引号不要少,另外里面是\,因为这是windows下。
经过这些后,点击run,久违的打印出现了:
System.loadLibrary("libMyJNILib");
}里可以加上一句:System.out.println(System.getProperty("java.library.path"));打印path的所有路径。整体代码如下:
- package org.yanzi.mylib;
- public class JNILib {
- static{
- System.out.println(System.getProperty("java.library.path"));
- System.loadLibrary("libMyJNILib");
- }
- public static native void jniPrint(String str);
- }
总结,网上常见的误解之处:
(JNIEnv *env, jclass jthis, jstring str) 事实证明这一步是多余的!