首页 > 代码库 > 将Cocos2d-x的libcurl单独打包到Android

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

研究了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方法
截图稍后上传。

3.3重头戏:使用libcurl.a打包的so库到Android







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