对于cocos2d-x开发者而言,游戏对多平台的支持是一个刚需,一般而言需要支持Android和iOS。然而,在开发过程中,android平台遇到的一系列问题着实让人头疼,本文以集成新浪微博分享SDK为例,从3个方面讲解Cocos2d-x在Android平台开发遇到的问题和解决方法。
ps. 如果你是新手,请先阅读Cocos2d-x的Android环境搭建
目前微博SDK为开发者提供 Oauth2.0 Web 授权认证,并集成 SSO 登录功能。你可以在这里下载android版本的SDK: https://github.com/sinaweibosdk/weibo_android_sdk
在 'readme.md' 中,可以看到普通JAVA应用程序的集成方式,所以,Oauth2.0和如何申请AppKey等问题,我们就不再啰嗦。但是对于Cocos2d-x游戏而言,坑爹的问题就出现了:SDK是用Java实现,那我们怎样在C++程序中调用Java接口呢?
接下来主角就出现了:JNI
JNI是JVM实现中的一部分,因此Native语言和Java代码都运行在JVM的宿主环境。JNI的出现使得开发者既可以利用Java语言跨平台、类库丰 富、开发便捷等特点,又可以利用Native语言的高效。
JNI是一个双向的接口:开发者不仅可以通过JNI在Java代码中访问Native模块,还可以在 Native代码中嵌入一个JVM,并通过JNI访问运行于其中的Java模块。可见,JNI担任了一个桥梁的角色,它将JVM与Native模块联系起来,从而实现了Java代码与Native代码的互访。
如下图:
缺点:由于Native模块的使用,Java代码会丧失其原有的跨平台性和类型安全等特性。但是这不是我们应该担心的,不是吗?哈哈
也就是说,JNI是帮助游戏在Java代码中调用Native接口和在Native代码中调用Java接口。
一般来说,要在Native代码中访问Java对象,有如下几个步骤:
得到该Java对象的类定义。JNI定义了jclass 这个类型来表示Java的类的定义,并提供了FindClass接口,根据类的完整的包路径即可得到其jclass 。
根据jclass 创建相应的对象实体,即jobject 。在Java中,创建一个新对象只需要使用new 关键字即可,但在Native代码中创建一个对象则需要两步:首先通过JNI接口GetMethodID得到该类的构造函数,然后利用NewObject接口构造出该类的一个实例对象。
所以,Native端的登陆接口实现如下:
1
2
3
4
5
6
7
8
9
10
|
int
WebAbility_WeiboLogin(
const
char
*clientID,
const
char
*redirector) {
*pEnv = getVMEnvironment();
jclass JavaClass;
JavaClass = (*pEnv)->FindClass(pEnv,
"com/Tyran/weiboSDK"
);
jmethodID methId = getMethodID(pEnv,JavaClass,
"WeiboLogin"
, JNI_TRUE);
jstring idStr = (*pEnv)->NewString(pEnv,clientID, getUcsLen(clientID));
jstring redirectorStr = (*pEnv)->NewString(pEnv,redirector, getUcsLen(redirector));
(*pEnv)->CallStaticVoidMethod(JavaClass, methId,idStr,redirectorStr);
return
JNI_TRUE;
}
|
要注意的地方:
FindClass要写明Java类的完整包路径,并将 “.”以“/”替换;
同样的,我们需要在java端创建一个登陆接口,用于调用验证框的webview:
1
2
3
4
5
6
7
8
|
public
static
void
WeiboLogin(String clientID, String redirector) {
Url = HEAD_URL + CLIENT_ID + clientID + RESPONSE_TYPE + REDIRECT_URI
+ redirector;
redirectorStr = redirector;
Intent i =
new
Intent(LaunchActivity.getInstance(),
WebViewActivity.
class
);
LaunchActivity.getInstance().startActivity(i);
}
|
这样,再继续实现webview相关接口,我们就能够调用微博的相关功能了,实现代码会开源出来,这里就不一一贴出来了。
以上是实现jni的基本方法,看起来很复杂,不是吗?所以Cocos2d-x对jni进一步封装了一次,可以实现更简单的调用方式。
2dx里面为我们提供了一个JniHelper类,来满足与Java层的数据交互,JniHelper可以很方便的调用java层的动静态方法。
getStaticMethodInfo、getMethodInfo
getStaticMethodInfo调用Java静态方法的方法:
getStaticMethodInfo(JniMethodInfo &methodinfo, const char *className, const char *methodName, const char *paramCode)
第一个参数为JniMethodInfo,为一个容器类,表示当前调用的方法
第二个参数为调用Java方法类的全名
java与Jni对应的参数类型如下:
ava类型 | 对应的签名 |
---|---|
boolean | Z |
byte | B |
char | C |
short | S |
int | I |
long | J |
float | F |
double | D |
void | V |
Object | Ljava/lang/String |
Array | Ljava/lang/String |
getMethodInfo类似与第一个函数,只是对应非静态函数;此函数主要用于获取Java定义的类非静态函数是否存在,返回bool;
此类型主要用户保存类结构体,可以通过JniHelper类的getStaticMethodInfo函数实例化JniMethodInfo对象,从而使用实例的env属性调用CallStaticVoidMethod,CallVoidMethod,CallStaticIntMethod等函数进行对保存的类结构调用函数;
1
2
3
4
5
|
JniMethodInfo t;
bool
isHave = JniHelper::getStaticMethodInfo(t,
"com/weibo/test/WeiboHelper"
,
//需要调用的Java文件
"toast"
,
//调用的方法名
"()V"
);
//参数
|
工程中,我们简单复用新浪微博demo中的java代码,所以,弹出的webview效果如下:
虽然Jni在cocos2d-x android工程中的运用很广泛,但是Android项目中,Activity主线程跟c++层是不同的,两者分属不同线程,也就是说,Android的UI线程并不安全,通过Jni直接调用java层方法来做刷新界面等操作是极度危险的。所以在集成一些第三方支付SDK的时候应该非常小心。