研究了N久+N次,终于在这一周解决了,感谢度娘。感觉第一次快要跑通时,心里真是万分紧张,感觉什么都不会再爱了。点下按钮,返回预期的值,OK。搞定,为此,放松了一个上午,现在来写写一些我是怎么搞通的吧。不敢保证,每个库都能这么搞,但是对一些刚入门者,应该有帮助。好的,开讲!
1、研究背景与意义
公司要单独封装网络库,所以,首先想到的libcurl,因为搞过半年Cocos2d-x,所以,直接找到了Cocos2d-x引擎源码的预编译第三方库里的libcurl。什么是预编译库?下面来解释解释。
1.1预编译库
所谓预编译库其实就是静态库,是一种可执行代码的二进制形式,可以被操作系统载入内存执行。在Linux或Unix下是以.a结尾的库文件。库文件首先会进行编译,当我们把库文件导入自己的动态或静态文件或工程中时,会提高代码的编译速度。静态库在代码编译的时候是已经被载入可执行程序的,体积较大,动态库是在执行程序时才载入内存,在编译的过程中简单的引用,因此代码体积较小。
这篇文章详细讲解了Linux下静态和动态库的基础知识。Linux库详解
1.2libcurl
Libcurl是一个开源免费的库文件,客户端传输库,支持FTP、FTPS、TFTP、HTTP、HTTPS、GOPHER、TELENT、DICT、FILE、LDAP等,C语言编写,跨平台,支持Windows、Unix、Linux等,线程安全,支持Ipv6,易于使用。
官网下载地址:http://curl.haxx.se/download.html
官网API详解:http://curl.haxx.se/libcurl/c/
其实主要是4个函数:1)curl_easy_init()初始化;2)curl_easy_setopt()设置属性;3)curl_easy_perform,连接。4)curl_easy_getinfo
这篇文章详细介绍了如何使用libcurl将下载内容写入内存:http://blog.163.com/xu_chao2000/blog/static/27770610200801303252802/
2、打包Android版libcurl包
关于打包libcurl包,网上有非常多的教程,由于Cocos2d-x已经为我们提供了几乎大部分平台的预编译库,即.a文件。所以,这一步我就在这省略了,虽然可能网上的教程有的比较坑爹,不过,多花些时间,综合起来,就会凑成一个完美的解决方案。
3、开始打包
在打包之前,我们可能需要学一下JNI和NDK编程的知识,不过,这些知识,也不是一篇两篇文章能解释清楚的,所以,这里也不打算讲解,有兴趣的可以翻看本人之前的博客,或者网上百度会有大篇大篇的文章。
3.1新建Android空工程
使用Eclipse新建Android工程。
1)由于Android本身新建工程并不包含jni目录,所以,我们需要自己添加该目录,并在该目录下添加两个文件。Android.mk和Application.mk这两个文件是ndk-build使用的文件。
2)拷贝Cocos2d-x的预编译库。我们需要的libcurl预编译库在Cocos2d-x引擎cocos2d-x-3.3rc0/external/curl目录下,将该目录下的两个文件include和prebuilt拷贝到我们上一步新建的android工程中。
3)删除include和prebuilt两个目录中android目录之外的的平台目录。因为我们用不到那些
4)更新Eclipse,可以看到,我们刚才的操作过后的目录如下:重点是jni目录下的改变(网络限制,暂时传不上来照片)
3.2先来一个简单例子,抛砖引玉
Android.mk文件可以说是本文最终要的一部分。我们先一步一步去讲一讲它。
首先阅读下这篇文章,预热一下,了解了解打包静态库和动态库的方法。
其次我们从NDK的samples的two-libs例子入手,分析mk的写法。(即搭建Android环境时,解压的NDK目录下的samples/two-libs)
先上代码
1)first文件:定义了一个加法的方法
//first.h #ifndef FIRST_H #define FIRST_H extern int first(int x, int y); #endif /* FIRST_H */ //first.c #include "first.h" int first(int x, int y) { return x + y; }
2)second.c:这个文件是Jni的相关的文件。
//second.c #include "first.h" #include <jni.h> //添加jni头文件 //下面这个函数的意思就是com.example.twolibs包com.example.androidlibcurldemo下MainActivity.java中的add方法。 jint Java_com_example_androidlibcurldemo_MainActivity_add( JNIEnv* env, jobject this, jint x, jint y ) { return first(x, y); }
这个add方法,是在我们上一步创建工程的src目录下的MainActivity.java中声明的两个native方法,说白了,second.c的作用就是,定义java中的native方法,并在实现中调用C的代码,如first.c中的first函数。相当于一个中介的样子。
3)Android.mk:例子中的Android.mk文件
#定义变量LOCAL_PATH指向mk所在的路径,如Android.mk文件在/usr/lib/curl/Android.mk #那么LOCAL_PATH代表的值就是:/usr/lib/curl #注意,这个变量没有清理,如果在后面引入其他mk文件,这个变量是可以传递到引入的mk文件中的 LOCAL_PATH:= $(call my-dir) # first lib, which will be built statically #CLEAR_VARS清理变量,因为这些变量都是静态全局的,如果不清了,下次编译时用到这些变量就会造成错误的 include $(CLEAR_VARS) #本地静态库模块名字,如果在别处导入库文件时,会用到这个名字 #此处名字的使用是libXXX.so或libXXX.a中的XXX的名字,也可以libXXX,不过,这两种在使用上还是有点区别的, #使用XXX或libXXX最后打包库后都是libXXX.a/so,在导入库模块时要使用LOCAL_LDLIBS := -lz来指明导入的是本地库 #否则会报找不到库的错误 LOCAL_MODULE := libtwolib-first LOCAL_SRC_FILES := first.c #创建静态库,注意,这个库是我们第一次创建,所以使用BUILD_STATIC_LIBRARY #如果LOCAL_SRC_FILES(即源码文件)使用的是.a则使用include $(PREBUILT_STATIC_LIBRARY),见下面代码 #如果使用的是.so文件,则使用include $(PREBUILT_SHARED_LIBRARY),PREBUILT表示使用的是预编译库里的源文件 include $(BUILD_STATIC_LIBRARY) # second lib, which will depend on and include the first one #清理变量 include $(CLEAR_VARS) #模块名称 LOCAL_MODULE := libtwolib-second #源码文件 LOCAL_SRC_FILES := second.c #导入关联的静态库,如果还有其它静态库,直接在后面添加即可,注意空格隔开 LOCAL_STATIC_LIBRARIES := libtwolib-first #最终创建动态库文件,libtwolib-second.so #如果最终创建静态库文件,是需要把SHARED改为STATIC即可,如libtwolib-first include $(BUILD_SHARED_LIBRARY)
4)Application.mk
我们在这个mk文件中只添加APP_ABI := all NDK就会为我们自动打包对应不同平台ABI的库文件,不同平台的库文件还是有区别的。
不过现在的Android手机大部分都是armeabi的,所以,如果不添加这句话,NDK默认的就会生成armeabi目录,并编译这个平台下使用的库文件。
5)编译库文件
我们进入到创建的Android工程,根目录即可,打开终端,如我使用的mac,打开终端后输入:
$ cd /Users/yuxikuo/Android_WorkPlace/AndroidLibcurlDemo
$ ndk-build
Android NDK: WARNING: APP_PLATFORM android-19 is larger than android:minSdkVersion 8 in ./AndroidManifest.xml [armeabi] Compile thumb : twolib-second <= second.c [armeabi] Compile thumb : twolib-first <= first.c [armeabi] StaticLibrary : libtwolib-first.a [armeabi] SharedLibrary : libtwolib-second.so [armeabi] Install : libtwolib-second.so => libs/armeabi/libtwolib-second.so
打包后的结果如上:Android中NDK将打包后的包文件拷贝到1)工程目录下的libs/下对应ABI目录下面,ABI表示当前机器的操作系统,一共有4类,不同的目标系统ABI有不同的打包方式和兼容性。2)同时还会在工程目录新建obj/local目录,该目录下同样根据不同的ABI拷贝对应的库文件。不过,不同的ABI目录是需要自己新建的,默认下是armeabi,因为大部分Android使用的是这个,并且它可以运行在所有ARM
CPU上。
armeabi => ARMv5TE以上
armeabi-v7a => ARMv7以上
x86 => x86平台
mips => mips
由于根据不同的ABI进行打包,那么我们每次都会生成4个包,打包过程见下面代码。
而且现在其他的平台并不常见,而且armeabi对其他平台也有兼容,所以,我们这里暂时只考虑armeabi平台下库文件的打包。
Android NDK: WARNING: APP_PLATFORM android-19 is larger than android:minSdkVersion 8 in ./AndroidManifest.xml [armeabi-v7a] Compile thumb : twolib-second <= second.c [armeabi-v7a] Compile thumb : twolib-first <= first.c [armeabi-v7a] StaticLibrary : libtwolib-first.a [armeabi-v7a] SharedLibrary : libtwolib-second.so [armeabi-v7a] Install : libtwolib-second.so => libs/armeabi-v7a/libtwolib-second.so //armeabi-v7a [armeabi] Compile thumb : twolib-second <= second.c [armeabi] Compile thumb : twolib-first <= first.c [armeabi] StaticLibrary : libtwolib-first.a [armeabi] SharedLibrary : libtwolib-second.so [armeabi] Install : libtwolib-second.so => libs/armeabi/libtwolib-second.so //armeabi [x86] Compile : twolib-second <= second.c [x86] Compile : twolib-first <= first.c [x86] StaticLibrary : libtwolib-first.a [x86] SharedLibrary : libtwolib-second.so [x86] Install : libtwolib-second.so => libs/x86/libtwolib-second.so //x86 [mips] Compile : twolib-second <= second.c [mips] Compile : twolib-first <= first.c [mips] StaticLibrary : libtwolib-first.a [mips] SharedLibrary : libtwolib-second.so [mips] Install : libtwolib-second.so => libs/mips/libtwolib-second.so //mips
6)在Java代码中调用。
在MainActivity.java中添加如下代码
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //super.onCreate(savedInstanceState); TextView tv = new TextView(this); int x = 1000; int y = 42; // here, we dynamically load the library at runtime // before calling the native method. //把生成的库load进来,注意去掉libXXX.so中的lib和so。只保留XXX System.loadLibrary("twolib-second"); int z = add(x, y); tv.setText( "The sum of " + x + " and " + y + " is " + z ); setContentView(tv); } public native int add(int x, int y);//native函数声明,在我们的second.c文件中定义,并使用了first.c中的first函数,实现加法
注意,如果出现错误或崩溃,看看second.c的函数包名是不是错误,然后看看有没有在java中声明native的add方法
截图稍后上传。