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

研究了N久+N次，终于在这一周解决了，感谢度娘。感觉第一次快要跑通时，心里真是万分紧张，感觉什么都不会再爱了。点下按钮，返回预期的值，OK。搞定，为此，放松了一个上午，现在来写写一些我是怎么搞通的吧。不敢保证，每个库都能这么搞，但是对一些刚入门者，应该有帮助。好的，开讲！

1、研究背景与意义

公司要单独封装网络库，所以，首先想到的libcurl，因为搞过半年Cocos2d-x，所以，直接找到了Cocos2d-x引擎源码的预编译第三方库里的libcurl。什么是预编译库？下面来解释解释。

1.1 预编译库

所谓预编译库其实就是静态库，是一种可执行代码的二进制形式，可以被操作系统载入内存执行。在Linux或Unix下是以.a结尾的库文件。库文件首先会进行编译，当我们把库文件导入自己的动态或静态文件或工程中时，会提高代码的编译速度。静态库在代码编译的时候是已经被载入可执行程序的，体积较大，动态库是在执行程序时才载入内存，在编译的过程中简单的引用，因此代码体积较小。

Linux下静态和动态库的基础知识，请查看《Linux库详解》一文。

1.2 libcurl

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应用：如何把下载内容写入内存》一文详细介绍了如何使用libcurl将下载内容写入内存。

2、打包Android版libcurl包

关于打包libcurl包，网上有非常多的教程，由于Cocos2d-x已经为我们提供了几乎大部分平台的预编译库，即.a文件。所以，这一步我就在这省略了，虽然可能网上的教程有的比较坑爹，不过，多花些时间，综合起来，就会凑成一个完美的解决方案。

3、开始打包

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文件：定义了一个加法的方法

1 2 3 4 5 6 7 8 9 10 11 12 13 14

//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的相关的文件。

1 2 3 4 5 6 7 8 9 10 11 12

//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文件

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

#定义变量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，打开终端后输入：

1 2	$ cd /Users/yuxikuo/Android_WorkPlace/AndroidLibcurlDemo $  ndk-build

1 2 3 4 5 6

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平台下库文件的打包。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

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中添加如下代码

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

@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分析：

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

1 2 3 4 5 6 7

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) //预编译成静态库

5）目录下的Android.mk分析：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

LOCAL_PATH:=$(call my-dir) #修改1 include $(LOCAL_PATH)/prebuilt/android/Android.mk # first lib, which will be built statically # include $(CLEAR_VARS)   LOCAL_MODULE    := libtwolib-first LOCAL_SRC_FILES := first.c   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 #修改2，尤其是-lz的作用，非常大             LOCAL_C_INCLUDES := $(LOCAL_PATH) LOCAL_LDLIBS := -llog \          -lz #修改3，增加cocos_curl_static库的导入，这就是我们在上面mk定义的 LOCAL_STATIC_LIBRARIES := libtwolib-first cocos_curl_static   include $(BUILD_SHARED_LIBRARY)

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

#include "first.h" #include <jni.h> #include <curl/curl.h>   jint Java_com_example_androidlibcurldemo_MainActivity_add( JNIEnv*  env,                                        jobject   this ,                                        jint     x,                                        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 style= "white-space:pre" >   </span>      return  first(res,res); //根据res值返回到Android中的TextView中，如果res是0，表示请求成功，如果是6表示无法解析主机，即没联网 }

7）编译库文件

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

3.4 如何使用库

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

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

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

至此，我们就完成了库的编译和使用。

Ctrl+R 打包APK到手机，点击button测试吧。不过这是同步请求，异步暂时还未研究。

以上步骤是经过真机测试（截图待补充）。

疑惑：打包时，如果我没有在second.c中引用<curl/curl.h>进行打包，包只有几十kb，引用后就1.2MB了，但是，我看了下libcurl.a的库本身就4点几MB，不知道什么原因，如有知道，烦请告知。

参考资料：

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

http://www.2cto.com/kf/201204/125939.html

http://jingyan.baidu.com/article/c910274bffa502cd361d2da0.html

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

http://www.cnblogs.com/lyout/archive/2013/06/03/3115799.html

http://www.linuxidc.com/Linux/2012-07/66105.htm

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

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

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

http://blog.csdn.net/huyiyang2010/article/details/766420

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

http://bbs.chinaunix.net/thread-4096875-1-1.html