2017年5月26日 星期五

Native Game Programming

用 Unity 做遊戲,C#寫遊戲程式,是工作上的必需。

用 C++ 寫手機遊戲程式,過程中有一種不同的樂趣與成就感。

所以我仍然抓著空餘時間套著 Android NDK 在手機上玩玩 Graphic,把以前半成品的 Engine 想辦法 Porting 到 Android 系統上玩。

對於要在 Visual Studio 上開發原生Android 程式,NVidia 的 Nsight Tegra for Visual Studio 是很好用的支援工具,當中的 Android Log Output 尤其好用。

android_log

即使是用 Unity 開發手機遊戲,這 Log Window 也幫助很大。

Android Logcat 輸出的訊息量很龐大,如果不能好好的過濾訊息,Debug 抓問題的時候,會幾乎不知從何下手。

Nsight Tegra 這套工具裡的 Log Output,給了還算完善的自訂過濾器功能,而且提供了 UI 來訂製過濾器。

所以我才會面對這樣的問題:

Visual Studio 今年改版出了 2017 版,但是 NVidia 遲遲不將 Nsight Tegra 支援 VS2017,以致我只能選擇繼續使用 VS2015或是,在 VS2017上用功能很差的Logcat。

最後我決定,在 VS2017上,自己開發個外掛,"山寨" Nsight Tegra 的 Log Output。

沒想到的是,我為了 Native Game Programming,還是繞了回來用 C#寫工具。

上面這句話才是本篇的重點。

這個 Extension 還沒完成,不過也還可以先給個 GitHub Link

Visual Studio Tool Window Extension for Android Logcat Output & Filter

2013年7月13日 星期六

Android NDK + Cocos2d-x + WinGDB Mobile + Visual Studio 2012

小小的搞定了 Cocos2d-x 這個跨平台開發的遊戲引擎,做個紀錄。

Android SDK, NDK 的安裝就不提了。WinGDB 有個 Mobile 版本,可以支援 Android NDK 的 Build 與 Debug,這個也要先安裝起來。

Cocos2d-x 先去下載來,這次裝的是新版本,Cocos-x 2.1.4。

接著就是整合的步驟了。

1. 以 WinGDB 建立新的 Project & Solution, “New Android Java+native package”

2. Cocos2dx SDK 裡的 Cocos2dx 目錄,複製到 Project Solution 目錄中,與 Package 的 src, res 等目錄同一層。

3. Solution 內 Add Project, "import Native Library android project", 導入 Cocos2dx 的 Android.mk, (project name “cocos2dx”, 不然會新增另一個目錄)

4. For Cocos2dx Project, Configuration/ Source, Additional C++ compile flags = -frtti, C++ Standard library = Static GNU libstdc++ image
Configuration/Target, Target ABI = armeabiimage
Common/General, Target Platform = android-10 (NDK 沒有 android-10, 會自動取用到 android-9)image

 

5. Cocos2dx_static 模組, Common/Compiler, Include Path 要設定相關的路徑image
Common/Linker, Linker Flags = -lGLESv2 -llog -lz -lEGL, Export Linker Flags = -llog –lz -lGLESv2image
其他的可以不用改變

 

6. Package Project, Common/General, Target Platform = android-10image
Common/API Levels, Minimum API Level = 10, Target API Level = 10,image
Configuration/Source, Additional C++ compile flags = -frtti, C++ Standard library = Static GNU libstdc++image
Configuration/Target, Target ABI = armeabiimage
Configuration/Debug, Debug Target Device 選用Device 或模擬器image

7. Package Project 的 Game Main 模組, Common/General, Module Type 為Shared Library image
Common/Compiler, Include Path 設定需要的路徑image
Common/Linker, Linked Static Library = libcocos2d libjpeg libpng libtiff libxml2, Linker Flags = -lGLESv2 -llog -lz -lEGL, Exported Linker Flags = -lGLESv2 -llog -lz -lEGLimage
其他的可以不用改變

 

8. 在 Package Project 內 Add new project item, 選擇 External Static library, Item name = cocos2d,image
設定模組的 Property, Common/General, Module type = External static library, External module path = ../obj/local/$(TARGET_ARCH_ABI)/libcocos2d.a (Like this)image
其他可以不須改變
同樣方式,import jpeg, png, tiff, webp 模組,使用在 third-party 目錄內的 .a

 

9. 把 cocos2dx\platform\android\jni 目錄裡的 .cpp,讓 GameMain 模組編譯,不要讓 cocos2d project 編譯。 cocos2dx\platform\android\src 裡的 org/cocos2dx/lib 裡的 java 檔,加入到 Package Project 的 src 目錄下。

10. Sample 程式碼的 main.cpp, Classes 內的.cpp, .h, 複製進來,建在jni目錄內。Sample src 目錄內的 java 檔,複製進來。在 android package project 內建立 assets 目錄,把 Resources 內的檔案,放在目錄內。

11. Solution 可以設定 Project Dependency, 然後 Build Solution。

12. Done!!

13. 如果使用 CocosDenshion, 類似 Cocos2d的方式加入 Solution。

2012年8月28日 星期二

第一支 Android App 上架,從無到有的全記錄 (4)

一個跟地圖有關的 App, 沒有地圖上的標記也是很奇怪的。所以,接下來我們要在地圖上加兩種標記。

首先我們要加上 Google Map API 提供的 MyLocationOverlay。

在 Main Activity 中宣告一個變數

private MyLocationOverlay m_MyLocationOverlay;

在 onCreate 函式裡,產生這個 Overlay,並且加入到 Map View 中。

m_MyLocationOverlay = new MyLocationOverlay(this, m_MapView);
m_MapView.getOverlays().add(m_MyLocationOverlay);

/*m_MyLocationOverlay.runOnFirstFix(new Runnable() {
    public void run() {
        m_MapView.getController().animateTo(m_MyLocationOverlay.getMyLocation());
    }
});*/

有一段程式碼註解起來了,這段程式碼的用意在,當我們取得 Location 後,把 Map View 上的地圖,搬移到我們所在的位置上。但是因為我們在 GeoUpdateListener 中也有相同的功能,所以,這段程式碼其實可有可無。

接著,在 Main Activity 上,我們覆寫兩個函式。

@Override
protected void onResume() {
    super.onResume();
    m_MyLocationOverlay.enableMyLocation();
    m_MyLocationOverlay.enableCompass();
}

@Override
protected void onPause() {
    super.onPause();
    m_MyLocationOverlay.disableMyLocation();
    m_MyLocationOverlay.disableCompass();
}

現在可以 Build 來測試看看。

device-2012-08-28-112023

如果用模擬器來跑的話,記得從模擬器上送出位置。

接下來,我們要來加上我們自己的標記。

首先,我抓了一個免費的藍色圖釘圖示。pin_blue加到 Android 專案的 resource 裡,名稱叫做 pin_blue。

然後,我們從 Map API 中的 ItemizedOverlay 抽象介面,實做一個叫做 PriLocOverlays 的類別。

public class PriLocOverlays extends ItemizedOverlay<OverlayItem>
{
    private static int MAXNUM = 50;
    private OverlayItem m_Overlays[] = new OverlayItem[MAXNUM];
    private int m_nCount = 0;

    public PriLocOverlays(Drawable defaultMarker) {
        super(boundCenterBottom(defaultMarker));
        // TODO Auto-generated constructor stub
    }

    @Override
    protected OverlayItem createItem(int i) {
        // TODO Auto-generated method stub
        return m_Overlays[i];
    }

    @Override
    public int size() {
        // TODO Auto-generated method stub
        return m_nCount;
    }

    public void addOverlay(OverlayItem overlay)
    {
        if (m_nCount < MAXNUM)
        {
            m_Overlays[m_nCount] = overlay;
            m_nCount++;
            setLastFocusedIndex(-1);
            populate();
        }
    }

}

OverlayItem 的陣列,我們必須要自己管理。我很簡單的只是用個固定陣列來放。然後再加個記數的變數。

createItem 以及 size 兩個函式是我們要實做的,就簡單的傳回陣列裡的物件跟數量就好了。要注意的是,這個 createItem 函式,並不真的需要去產生一個 Item,每次 Map View 需要更新 Overlay 時,都會呼叫這個函式。

在我們自己的 addOverlayItem 內,我們需要呼叫 populate 函式,通知 Map View 來更新這個 Overlay。並且,最好是在呼叫 populate 之前,呼叫 setLastFocusedIndex(-1),清掉之前的 Focus Item,否則咧,會因為找不到之前的 Focus Item 而讓 App Crash 的。( 我實際接到過這個問題的 Bug 回報,還好已經有神人找到問題解答了... )

接著,改 Main Activity,加入 PriLocOverlays 的變數,並且在 onCreate 中建立它。

Drawable drawable = this.getResources().getDrawable(R.drawable.pin_blue);
m_PrivateLocOverlay = new PriLocOverlays(drawable);
m_MapView.getOverlays().add(m_PrivateLocOverlay);

我們還需要有一個把目前位置建立成 OverlayItem 加入到 PrivateLocOverlay 裡的功能。就做在 Option Menu 裡吧...

在 Main Activity 加入函式。

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    if (item.getItemId() == R.id.menu_settings)
    {
        OverlayItem overlay = new OverlayItem(m_MyLocationOverlay.getMyLocation(), "Test Loc", "");
        m_PrivateLocOverlay.addOverlay(overlay);
        //requestAddCurrentLocation();
        return true;
    }
    return super.onOptionsItemSelected(item);
}

於是乎,程式跑起來就像這樣。

device-2012-08-28-131318

 

呃...

本來想,就先寫到這樣吧,後來又覺得該寫下這個...

我們在 PriLocOverlays 類別裡,可以覆寫 onTap ( int index ) 這個函式。

當地圖上的標記被點選到的時候,onTap 函式會被呼叫。這時候,我們可以用 index 取出 OverlayItem,進行處理。

@Override
protected boolean onTap(int index)
{
    OverlayItem overlayItem = m_Overlays[index];
    Toast.makeText(m_Activity, overlayItem.getTitle(), Toast.LENGTH_LONG).show();
    // TODO Auto-generated method stub
    return super.onTap(index);
}

我沒多做什麼,就是用 Toast 顯示了一下。

結果就類似這樣。

image

2012年8月20日 星期一

第一支 Android App 上架,從無到有的全記錄 (3)

先再幫自己工商服務一下...

https://play.google.com/store/apps/details?id=com.lancelot.privatelocationdatabase

接著前兩篇的內容。

可以載入地圖之後,下一個要做的事,就是抓到我們的位置,還有,把地圖移到我們所在的位置上。

我們需要的是 LocationManager, LocationListener, 還有 MapController。

LocationManager 的作用是定位我們現在的位置,然後再將定位的結果傳喚給 LocationListener。不過呢,LocationListener 是一個抽象類別,需要我們自己去繼承實做,主要要實做 onLocationChanged 這個函式。

所以,我們先建立一個 GeoUpdateListener 類別。

public class GeoUpdateListener implements LocationListener {

    MapController m_MapController;
    GeoPoint m_geoCurrentLoc;
    MainActivity m_Activity;
   
    public GeoUpdateListener(MainActivity activity, MapController map_controller)
    {
        m_MapController = map_controller;
        m_Activity = activity;
    }
    public void onLocationChanged(Location location) {
        // TODO Auto-generated method stub
        int lat = (int) (location.getLatitude() * 1E6);
        int lng = (int) (location.getLongitude() * 1E6);
        m_geoCurrentLoc = new GeoPoint(lat, lng);
        m_MapController.animateTo(m_geoCurrentLoc);
    }

    public void onProviderDisabled(String provider) {
        // TODO Auto-generated method stub

    }

    public void onProviderEnabled(String provider) {
        // TODO Auto-generated method stub

    }

    public void onStatusChanged(String provider, int status, Bundle extras) {
        // TODO Auto-generated method stub

    }

}

onLocationChanged 的程式碼很簡單,就是把取得來的位置,經緯度轉換成 MapController 能用的整數格式,生成 GeoPoint 物件後,交給 MapController,MapController 就會把地圖移動到我們指定的位置上。

接著改 Main Activity。

加入幾個 Private 變數。

private MapController m_MapController;
private MapView m_MapView;
private LocationManager m_LocationManager;
private GeoUpdateListener m_GeoUpdateListener;

在 Main Activity 的 onCreate函式裡,加入 Location Manager, Geo Update Listener, 取得 Map View, Map Controller。

        m_MapView = (MapView)findViewById(R.id.mapview);
        m_MapView.setBuiltInZoomControls(true);
        //m_MapView.setSatellite(true);
       
        m_MapController = m_MapView.getController();
        m_MapController.setZoom(14); // Zoom 1 is world view
       
        m_GeoUpdateListener = new GeoUpdateListener(this, m_MapController);
       
        m_LocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
        m_LocationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 1000,
                0, m_GeoUpdateListener);
        // also need 3G GPS
        m_LocationManager.requestLocationUpdates(LocationManager.NETWORK_PROVIDER, 1000,
                0, m_GeoUpdateListener);

那,從 Code看。

Location Manager 要從 System Service 中取得。

位置的提供者,有兩種,從 GPS 來,以及從手機基地台定位而來。我們可以兩種都用。所以在 requestLocationUpdates 函式裡,會有兩種參數 GPS_PROVIDER & NETWORK_PROVIDER。

同時,我們也告訴Location Manager,位置更新的時候,請呼喚 GeoUpdateListener。

程式就改到這邊。

還有一個地方要更動一下。在 AndroidManifest.xml 裡,要加入兩個 Permission。

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

現在我們可以做測試了。

不過這次,我們想用模擬器來玩。

因為,這個 App 的 Build Target 是 Google API,所以,我們必須要建立一個 Google API 的 模擬器。

image

開啟模擬器之後,跑起 App。

image

但是這樣的東西好像沒有定位的功能呢,怎麼辦?

把 Eclipse IDE 上的 DDMS 打開,有個 Emulator Control 的分頁,可以找到 Location Control 的功能。

image

我們試試看,把 Longitude 改成 –122.08, Latitude 改成 37.42,

image

地圖就改到別的地方啦!!

2012年8月16日 星期四

第一支 Android App 上架,從無到有的全記錄 (2)

這樣說吧, App 裡頭要使用 Google Map 的資料,需要 Google 的授權。所以, Google 要求開發者要登記一個 Google Map API 的金鑰。App 還在開發中的時候,先使用 Debug 版的金鑰就可。至於發佈版的金鑰,後面再說吧。

取得金鑰前,先要簽署 Maps API。

Sign Up for the Android Maps API - Android Maps API - Google Code

image

打勾,填入 MD5 Fingerprint,然後按下 "Generate API Key"。

MD5 Fingerprint 哪裡來??

Android SDK 附有一個名稱為 "debug.keystore" 的檔案。

  • Windows Vista / Windows 7: C:\Users\<user>\.android\debug.keystore
  • Windows XP: C:\Documents and Settings\<user>\.android\debug.keystore

在這個檔案的目錄內,建立一個 bat 檔。內容寫一行

<jdk path>\bin\keytool -list -v -alias androiddebugkey -keystore debug.keystore -storepass android -keypass android >> debug_map_key.txt

<jdk path> 是 Java SDK 的安裝目錄。

執行 bat 檔以後,會將輸出內容寫到 debug_map_key.txt 檔案裡。檔案裡就可以看到這麼一段 :

別名名稱: androiddebugkey
建立日期: 2012/1/18
項目類型: PrivateKeyEntry
憑證鏈長度: 1
憑證 [1]:
擁有者: CN=Android Debug, O=Android, C=US
發出者: CN=Android Debug, O=Android, C=US
序號: 4f162768
有效期自: Wed Jan 18 09:59:04 CST 2012 到: Fri Jan 10 09:59:04 CST 2042
憑證指紋:
     MD5:  1F:04:CE:54:D2:57:0D:7C:11:1F:5D:A1:B2:D6:E8:93
     SHA1: 4E:D1:A5:3E:68:F2:05:C8:09:9C:29:9C:A9:38:29:4C:3C:3B:A8:1A
     SHA256: C9:DA:67:77:3F:4B:94:F5:AE:47:7F:FF:A6:14:9C:B5:96:10:00:7E:99:C8:45:40:A3:64:9F:83:BA:12:56:D1
     簽章演算法名稱: SHA1withRSA
     版本: 3

那一行 MD5 就是我們要的。

複製貼上到網頁上,按下 "Generate API Key"。

image

到此,我們就取得金鑰了。

回到 Eclipse IDE 的程式碼。

在 main activity 的 layout xml 檔案裡,把 android:apiKey 那一段,"your key" 改為我們取得的金鑰。

    <com.google.android.maps.MapView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/mapview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:apiKey="0vn4fYcAmXsjC902Q8puaWZLabVkY0t5jqjRzSw"
    android:clickable="true" />

再來,因為我們需要透過 Internet 下載地圖資料,所以,要在 AndroidMenifest.xml 裡加入 Internet 的 Permission。

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

現在 Build 執行看看吧...

2012-08-16_10-25-01

看到地圖囉!!!

可是看不到街道、看不到自己的位置...

那是後續的工作...

2012年8月15日 星期三

第一支 Android App 上架,從無到有的全記錄 (1)

screen_1screen_2

這支 App 用到三個程式模組,Google 地圖、資料庫、還有廣告。

App 所要達到的功能,很簡單 :

當出遊或是閒晃時,走到某個值得記錄的地點,可以將它標記起來。未來再度行經附近的時候,地圖上就會標示出來。

花了一陣子的業餘時間,前幾天丟到架上了。( 歡迎下載 )

https://play.google.com/store/apps/details?id=com.lancelot.privatelocationdatabase

好,先從 Google Map 開始。

要用 Google Map 功能,先需要 Google Map 的 API。

Android 雖然跟 Google 關係匪淺,但是, Android SDK 本身是不含有 Google Map 相關功能的,所以,必須要透過 Android SDK Manager 工具,下載 Google APIs。這一大包裡頭,就有 Google Map 相關的類別。

image

接著,可以從 Eclipse IDE 建立 Android Application 專案。專案的 Build Target 要改用 Google APIs。

image

然後應該就可以生出個預設的 Hello World 程式了。

接著先在 AndroidManifest.xml 檔案中,加入 Use Library 到 Application裡。我們要使用的是 com.google.android.maps 這個 package。

<uses-library android:name="com.google.android.maps"/>

image

然後在主畫面的 layout xml 檔案裡,加入 Map View 元件。

    <com.google.android.maps.MapView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/mapview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:apiKey="your_key"
    android:clickable="true" />

最後,把主要 Activity 改為從 MapActivity 繼承。

import com.google.android.maps.MapActivity;

import android.os.Bundle;
import android.view.Menu;

public class MainActivity extends MapActivity {

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.activity_main, menu);
return true;
}

@Override
protected boolean isRouteDisplayed() {
// TODO Auto-generated method stub
return false;
}


}

好了,趕快 Build 一下,看一下成果。

成果是,只看到方格線,還有一個 Google 的浮水印。其他什麼都沒有。

2012-08-15_19-07-01

因為我們還有一個很重要的 Map API Key 還沒取得。

2012年5月9日 星期三

Unity3D Plug-in for Android -- Activity 擴展方法

Unity3D 的 Android Plug-in 還有另一種實做方法。當需要使用 Android SDK 中的 Java 物件時,利用這個方法來將 Unity3D 與 Android SDK 結合是比較好的。

簡單的步驟,

1. 先在 Eclipse IDE 中,新建一個 Android Project。

2. 在 Project 的 Property 中,點選 Java Build Path,切到 Libraries 的分頁,按鈕 "Add External JARs…",然後選擇 Unity 安裝目錄,找到 "\Editor\Data\PlaybackEngines\androidplayer\bin" 子目錄裡的檔案 classes.jar 來加入
clip_image002

3. 修改 Activity 的 Java Code

Activity 改成自 UnityPlayerActivity 繼承 ( import com.unity3d.player.UnityPlayerActivity ),在 Activity 的 OnCreate 函式裡,把預先產生的 setContentView() 函式呼叫刪除掉不要使用。

一個範例程式碼如下: ( UnityPlayerExtendActivity.java )
這個範例裡,我們不但使用了 Toast,還用到了Android SDK 中的 藍芽 API。這兩項功能,都是Unity3D無法提供的。

package com.activity.unityextend;

import com.unity3d.player.UnityPlayerActivity;

import android.os.Bundle;

import android.widget.Toast;

import android.bluetooth.BluetoothAdapter;

public class UnityPlayerExtendActivity extends UnityPlayerActivity {

private BluetoothAdapter mBluetoothAdapter = null;

/** Called when the activity is first created. */

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

//setContentView(R.layout.main);

mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();

if (mBluetoothAdapter == null) {

Toast.makeText(this,

"Bluetooth is not available.",

Toast.LENGTH_LONG).show();

finish();

return;

}

if (!mBluetoothAdapter.isEnabled()) {

Toast.makeText(this,

"Please check your BT settings.", // and re-run this program

Toast.LENGTH_LONG).show();

//finish();

//return;

}

}

}

另外呢,AndroidManifest.xml 這個檔案,需要調整一下。因為我們用到了藍芽功能,所以要開啟應用程式的藍芽權限。

image

4. 接著從 Eclipse IDE Export 出 jar 檔案。

 clip_image002[6]
clip_image004

5. 下一步,開啟 Unity3D,修改 Player Settings 設定。要注意的是, Bundle Identifier 與 Minimum API Level 要與 Eclipse 上的 Android Project 相同。

6. 然後將 Eclipse 的 Android Project 檔案複製到 Unity 專案的目錄下, 這裡有幾個需要複製的檔案。

clip_image008 


a. 在 Assets 目錄下建立 Plugins 目錄,再建立 Android 子目錄。

b. 將 Android Project 中的 AndroidManifest.xml 複製到 Plugins/Android 目錄內。

c. 在 Plugins/Android 目錄內建立 bin 子目錄,將 Android Project 輸出的 jar 放進來。

d. 最後將 Android Project 內的 res 子目錄複製到 Plugins/Android 目錄內

7. 最後,從 Unity3D Build & Run,就可以使用 Android SDK 提供的功能了。

 

 

(Update 2012.7.5) 加入了 AndroidManifest.xml 該修改的部分