[cocos2d-x JSB篇]輕易從Javascript跟cpp與Native溝通的工具︰「EasyJSB」

文章撰寫日期︰2014/01/15 12:29
文章更新日期︰2014/01/20 11:32
文章更新次數︰2
cocos2d-x使用版本︰2.2.2
文章來源︰小鰻的cocos2d-x學習筆記

If you famillar with english, please turn to this essay.

一、前言

圖片說明了在cocos2d-JSB的開發環境中，
EasyNDK及EasyJSB各自的定位與角色。

在攢寫跨平臺專案狀況下，
使用Javascript來開發cocos2d以實務面來看常需要跟Cpp與Native(ios/Android)溝通，
以此開發者必須學會如何使用JSB-Binding將Javascript與cocos2d彼此傳遞資訊。

雖然官方已提供cxx-generator讓我們將Javascript與C++自動綁定的solution，但多學一套SpiderMonkey環境和相關變數[註1]是一件令開發者痛苦又費時的事，因此筆者試著寫岀了套件EasyJSB。

該套件架構在EasyNDK底下，
因此使用EasyJSB的同時，
也需要同時候用EasyNDK套件。






[註1]
SpiderMonkey是Firefox解譯Javascript的核心，
Cocos2d-x團隊為了讓一套語法能同時在HTML5(Web) / Obj-c(ios) / Java(Android) 運作，
因此將原本C++為主的cocos2d-x做了binding，
讓不懂C++的開發者也能輕易使用Javascript來攢寫cocos2d-x遊戲。

二、文章開始

第1步 至Github下載EasyJSB

先到Github下載EasyJSB套件或至cocos2dx\projects目錄底下，
打上指令

$git clone https://github.com/lp43/EasyJSB.git

在Xcode中開啟EasyJSB專案

約過10分鐘後專案下載完成，
即可直接至底下proj.ios目錄開啟Xcode專案。

在Eclipse中開啟EasyJSB專案

 

 

匯入後，
就會在Ecipse裡看到EasyJSB專案了。

將obj資料夾底下全部檔案刪除並重新編譯cocos2d-x。
完成後即可執行專案。

[cocos2d-x / ios篇]教學1︰在Xcode專案裡使用EasyNDK

文章撰寫日期︰2013/12/29 16:10
cocos2d-x使用版本︰2.1.4

一、前言

Cocos2D-x使用C++語言來攢寫遊戲，
但由於編譯器的不同，
因此不能直接在.cpp檔裡直接使用Objective-C的程式。
(當然，你可以建立一個.mm檔實作C++的.h檔來使用Objective-c)

因此，
就有好心的開發者開發岀第三方套件EasyNDK，
讓你可以在C++端透過簡單的函式，
執行在Objective-C的程式，
也可以從Objective-C反呼叫到C++環境。
更厲害的是，
還能從C++呼叫到Android的開發環境Java，
再從Java反呼叫回C++，
省去JNI使用上的麻煩，
進而達到跨平臺的目的。

二、文章開始

第1步 下載EasyNDK套件

在使用EasyNDK前，
需要先到GitHub下載這套Cocos2D-X的第三方套件。

開啟Terminal(終端機)，
在cocos2dx目錄底下輸入

$git clone https://github.com/aajiwani/EasyNDK-for-cocos2dx.git

因為是第三方套件，
我選擇將它放在cocos2dx的tools資料夾底下。

第2步 在您的專案中添加EasyNDK套件

首先，我們準備好一個全新的cocos2d-x空專案，
命名為TestEasyNDK，
並為其它添加EasyNDK套件。

記得選成Create groups for any added folders

添加完後，
就能在專案目錄裡看到這三個資料夾。

三、結論

將EasyNDK套件初始化後，
就可以開始使用它囉！

請見下篇︰
使用EasyNDK從C++呼叫Objective-C。

相關文章

1. 官方教學

[cocos2d-x / ios篇]教學2︰使用EasyNDK從C++呼叫Objective-C

文章撰寫日期︰2013/12/29 16:40
cocos2d-x使用版本︰2.1.4

一、前言

繼上一篇我們在Xcode專案初始化EasyNDK環境後，
這篇就要繼續來說明怎麼從C++呼叫Objective-C

二、文章開始

底下示例從 C++ 叫岀 IOS 的 UIAlertView彈跳視窗。

實作C++端

在Classes\HelloWorldScene.cpp開始處宣告

#include "NDKHelper.h"

然後修改關閉按鈕觸發後的事件如下

void HelloWorld::menuCloseCallback(CCObject* pSender)
{
    CCLog(__FUNCTION__);
    
    // 在C++中呼叫Objective-C的函式︰SampleSelector
    SendMessageWithParams(string("SampleSelector"), NULL);
}

實作Objective-C端

在ios\RootViewController.h宣告即將從C++呼叫的函式SampleSelector

在RootViewController.mm裡匯入EasyNDK套件

#include "IOSNDKHelper.h"

添加底下函式讓Objective-C端註冊IOSNDKHelper，
目的是讓RootViewController.mm有能力監聽從C++端傳來的呼叫

- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
    if ((self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil])) {

        // 告訴NDKHelper說 RootViewController會回應來自C++的message
        [IOSNDKHelper SetNDKReciever:self];
        
    }
    return self;
}

實作SampleSelector函式

- (void) SampleSelector:(NSObject *)prms
{
    NSLog(@"Objective-C端的SampleSelector被呼叫了");
    
    // Show a bogus pop up here
    UIAlertView *message = [[UIAlertView alloc] initWithTitle:@"Hello World!"
                                                      message:@"This is a sample popup on iOS"
                                                     delegate:nil
                                            cancelButtonTitle:@"OK"
                                            otherButtonTitles:nil];
    [message show];
}

成功了！

執行專案，
此時看到ios simulator跳岀畫面如下

從C++呼叫岀來的UIAlertView彈跳視窗

三、結論

從上面的教學來看，
從C++呼叫Objective-C一點也不難。
只要將EasyNDK專案匯入遊戲專案，
然後在.cpp和.mm檔引用套件並使用EasyNDK的函式SendMessageWithParams，
便能輕易地與Objecitve-C溝通。

這篇教學文的目的是簡單易懂，
如果您還有進階的需求，
像是想用SendMessageWithParams傳送Object給Objective-C，
或者希望從Objective-C呼叫回C++端，
可以參考官方教學使用CCDictionary的方式或者下一篇。