将Cocos2d-x的libcurl单独打包到Android_app

概述研究了N久+N次，终于在这一周解决了，感谢度娘。感觉第一次快要跑通时，心里真是万分紧张，感觉什么都不会再爱了。点下按钮，返回预期的值，OK。搞定，为此，放松了一个上午，现在来写写一些我是怎么搞通的吧。不敢保证，每个库都能这么搞，但是对一些刚入门者，应该有帮助。好的，开讲！ 1、研究背景与意义公司要单独封装网络库，所以，首先想到的libcurl，因为搞过半年Cocos2d-x，所以，直接找到了Co

研究了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_Hextern 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方法。jintJava_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-firstLOCAL_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-firstinclude $(BUILD_SHARED_liBRARY)

4）Application.mk

我们在这个mk文件中只添加APP_ABI := allNDK就会为我们自动打包对应不同平台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方法
截图稍后上传。 3.3重头戏:使用libcurl.a打包的so库到AndroID

1）首先，看看我们之前拷贝到jni目录下的两个文件夹include和prebuilt。对了，这两个目录是我阉割的，把其它无关平台的目录删除了。

2）include目录下是libcurl.a库中源文件的头文件。我们也需要将它打包进包里面，才能在涉及到包时，自动引入头文件。

3）prebuilt目录是存放libcurl.a的目录，我们暂时保存Cocos2d-x的目录结构，这样，我们就免得修改下面的AndroID.mk文件了

4）/prebuilt/androID目录下的AndroID.mk分析：

@H_301_256@注意为了减少路径上的问题，我将include文件夹拷贝到了和该AndroID.mk文件相同的路径下了

LOCAL_PATHA:=$(call my-dir)//当前路径变量，注意，我在该处设置的变量名是LOCAL_PATHA，因为后面需要导入这个mk文件，防止变量冲突include $(CLEAR_VARS)//清理变量LOCAL_MODulE := cocos_curl_static //模块名称LOCAL_MODulE_filename := curl  //生成的包名LOCAL_SRC_fileS := prebuilt/androID/$(TARGET_ARCH_ABI)/libcurl.a  //依赖的源文件，注意：路径一定要为相对路径，这一块比较容易出错LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATHA)/include/androID  //为了能在库外面使用库的方法，需要引入头文件include $(PREBUILT_STATIC_liBRARY)//预编译成静态库

4）目录下的AndroID.mk分析：

LOCAL_PATH:=$(call my-dir)#修改1include $(LOCAL_PATH)/prebuilt/androID/AndroID.mk# first lib,which will be built statically#include $(CLEAR_VARS)LOCAL_MODulE    := libtwolib-firstLOCAL_SRC_fileS := first.cinclude $(BUILD_STATIC_liBRARY)# second lib,which will depend on and include the first one#include $(CLEAR_VARS)LOCAL_MODulE    := libtwolib-secondLOCAL_SRC_fileS := second.c#修改2，尤其是-lz的作用，非常大 			LOCAL_C_INCLUDES := $(LOCAL_PATH)LOCAL_LDliBS := -llog \		-lz#修改3，增加cocos_curl_static库的导入，这就是我们在上面mk定义的LOCAL_STATIC_liBRARIES := libtwolib-first cocos_curl_staticinclude $(BUILD_SHARED_liBRARY)

5）重写second.c，调用libcurl中的方法，进行网络请求

@H_419_277@#include "first.h"#include <jni.h>#include <curl/curl.h>jintJava_com_example_androIDlibcurldemo_MainActivity_add( jnienv* env,jint y ){ CURL* curl; CURLcode res; curl = curl_easy_init(); if(NulL == curl)//如果初始化失败，返回1000 { return first(1,999); } curl_easy_setopt(curl,CURLOPT_URL,"http://www.baIDu.com");//以get请求www.baIDu.com curl_easy_setopt(curl,CURLOPT_READFUNCTION,NulL); curl_easy_setopt(curl,CURLOPT_NOSIGNAL,1); curl_easy_setopt(curl,CURLOPT_CONNECTTIMEOUT,20);//连接时间，由于网络不好，为了达到测试效果，我设置的时间较长 curl_easy_setopt(curl,CURLOPT_TIMEOUT,20); res = curl_easy_perform(curl);//执行 curl_easy_cleanup(curl);//清除<span > </span> return first(res,res);//根据res值返回到AndroID中的TextVIEw中，如果res是0，表示请求成功，如果是6表示无法解析主机，即没联网} 6）编译库文件

同样还是在终端中，先进入到AndroID工程目录，然后执行ndk-build。最终在obj和libs目录下生成了我们的libtwolib-second库

3.4如何使用库 1）首先，还是要修改我们的MainActivity.java类，修改如下：

private button button;	private TextVIEw tv;	private int x  = 123;    private int y  = 456;    @OverrIDe    protected voID onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentVIEw(R.layout.activity_main);        // here,we dynamically load the library at runtime        // before calling the native method.        //        System.loadlibrary("twolib-second");        tv = (TextVIEw)findVIEwByID(R.ID.textVIEw2);        button = (button) this.findVIEwByID(R.ID.button1);        this.button.setonClickListener(new OnClickListener() {						@OverrIDe			public voID onClick(VIEw arg0) {								 int  z = add(x,y);			     tv.setText( "网络请求结果" + z );			}		});    }    public native int add(int  x,int  y);

我们要在activity_main布局中，添加一个按钮和一个TextVIEw，按钮用于出发网络请求，TextVIEw用于显示请求结果。显示0表示请求成功。显示12表示无法解析主机，没联网。 2）在AndroIDManifest.xml中添加网络权限。否则会在TextVIEw显示12

<uses-permission androID:name="androID.permission.INTERNET"/>

至此，我们就完成了库的编译和使用。 Ctrl+R 打包APK到手机，点击button测试吧。不过这是同步请求，异步暂时还未研究。
以上步骤是经过真机测试，截图如下：网络限制，稍后上传。
疑惑：打包时，如果我没有在second.c中引用<curl/curl.h>进行打包，包只有几十kb，引用后就1.2MB了，但是，我看了下libcurl.a的库本身就4点几MB，不知道什么原因，如有知道，烦请告知。

参考资料：

1）http://blog.csdn.net/sozell/article/details/10551309

2）http://www.2cto.com/kf/201204/125939.HTML

3）http://jingyan.baIDu.com/article/c910274bffa502cd361d2da0.HTML

4）http://blog.csdn.net/smfwuxiao/article/details/6591927

5）http://www.cnblogs.com/lyout/archive/2013/06/03/3115799.HTML

6）http://www.linuxIDc.com/linux/2012-07/66105.htm

7）http://blog.csdn.net/smfwuxiao/article/details/8523479

8）http://blog.csdn.net/yuxikuo_1/article/details/39577257

9）http://bbs.csdn.net/topics/370006153

10）http://blog.csdn.net/huyiyang2010/article/details/7664201

11）http://blog.csdn.net/cjj198561/article/details/33417965