Doja3.5(主要機型N900iG，原始版本S700)移植流程

1.       修改import部分

主要在每個包含import的代碼文件中，將原來MIDP版本專有的class-path改成DoJa專有的，主要是添加如下代碼在文件頭：

import com.nttdocomo.io.*;

import com.nttdocomo.ui.*;

2.       入口類不同

在MIDP中主類是繼承MIDlet,而Doja是繼承Iapplication類。雖然本質上兩個類功能幾乎一樣,但也有一些區別:

返回游戲時,MIDlet是調用startApp()(開始時也會被調用).而在Doja中resume()函數被調用以及一個Display.RESUME_VM_EVENT消息發送到當前Display對象.這在中斷處理可能會需要用到.

3.       添加下載代碼

DoJa3.5支持最大100K的Jar包和最大400K的scr(ScratchPad----草稿板)，scr在被下載到設備上之前，是以每個大小不超過10K的raw文件組成，我們需要在程序中自己寫代碼來實現所有raw文件的下載和拼接功能。

主要的思路是：打開一個網絡數據流，將對應的raw分塊寫入事先生成的空白scr中，并在scr末尾添加一個counter，每下載一個分塊，counter+1。由程序判斷counter值是否等于需要下載的分片數，相等則直接進入游戲。

4.       修改存儲方式

MIDP中用到的是記錄存儲方式(recordStore)，而DoJa3.5中沒有對應的功能函數，游戲數據是直接寫在scr里面的，所以在下載raw到scr中時，我們不能將scr全部填滿，一定要預留足夠的空間來存儲游戲數據。草稿板的IO操作與變通文件操作一樣,只有有點需要特別注意的地方就是不能使用skip函數.

5. 修改資源的讀取方式

在草稿板中，詳細記錄了打包所用到的資源文件數，每個文件的大小（通過一個位移偏移量來標示），所以，在讀取資源之前，首先要讀取這些“預信息”，再根據這些偏移量找到相應得打包文件，這一點與MIDP是不一樣的，需要注意。

將資源打入草稿板中的工具和方法有很多，我們通過列表來說明，各位可以根據需要來選擇適合自己的工具：

工具	使用方法
CreateSP.exe (批處理方式,省事,但要復雜一些)	echo *** building ScratchPad...        set DATA_OUT_PATH=%PROJ_DIR%\data\#build\TRIPLETS_EN        del %PROJ_DIR%\sp\*.raw > NUL        del %PROJ_DIR%\sp\*.scr > NUL       set TOOLS_PATH = %PROJ_DIR%\tools        cd "%PROJ_DIR%\data\phone\%PHONE%\pack        Echo *** calling "_SPList.bat"        call _SPList.bat        "%PROJ_DIR%\tools\DojaTools\CreateSP.exe" ##ScratchPad.txt %PROJ_DIR%\sp\%PROJ_FULL_NAME%_%VERSION_NUMBER%.raw %PROJ_DIR%\sp\%PROJ_FULL_NAME%.scr 340        del sp.h > NUL        del %PROJ_DIR%\sp\%PROJ_FULL_NAME%_%VERSION_NUMBER%.raw > NUL          cd %BUILD_PATH%
	藍色部分為批處理文件中的主要部分，340（單位是K）是用CreateSP.exe生成的草稿板的大小，如果實際數據塊總大小小于這個數值，則以0補全。##ScratchPad.txt中需要將準備打入草稿板的數據塊文件的名字及路徑進行列表（由批處理文件_SPList.bat實現）。
	Src文件格式: 4Bytes-> 所有raw文件大小 4Bytes無用 4Bytes-> 所有打包文件個數n 4Bytes無用 n個 { 4Bytes-> 打包文件的偏移量(offset) 4Bytes無用 }
DaTool.exe (手動方式,麻煩一點,簡單)	打開Datool.exe 按ALT+P打開資源列表文件ScratchPad.txt然后open既可.大小由列表文件中所指定文件大小而定.
	ScratchPad.txt 格式: (第一行為輸入scr文件路徑,從第二行開始為所有文件列表,可以為相對路徑) Output file name:..\sp\%PROJ_DIR%\sp\%PROJ_FULL_NAME%.scr .\data\a.bin .\data\c.bin .\data\data0.bin .\data\p.bin .\data\s.bin ..\music\a0.mld ….
	Src文件格式: 2Bytes -> 所有文件個數 4Bytes -> src文件大小 I =  (0 … 文件總數 - 1 )    4Bytes -> 第(I)個文件的偏移
注	在用模擬器時,Doja3.5草稿板的命名與jam名一樣,并且需要在后面加個0

6. 修改圖片創建代碼

在DoJa3.5中，圖片對象的創建不是簡單的createImage，我們的做法是：先將圖片數據讀入一個byte數組中，用這個數組來實現圖片的創建。可以從下面的代碼中看到，我們首先用getImage()從buff中得到一個MediaImage對象temp，用use()方法激活這個對象，然后用getImage()從這個對象得到我們需要的Image對象，最后，將temp置為null。

            //示例代碼

              Image mImg[];

              byte buff[]=new byte[headerSize+paletteSize+dataSize];

              System.arraycopy(bufferImage, 0, buff, 0, headerSize+paletteSize+dataSize);

              MediaImage temp = MediaManager.getImage(buff);

              try{

                     temp.use();

              }catch(ConnectionException ce){}

              mImg[refImg]= temp.getImage();

              temp=null;

       DoJa3.5支持Gif和Jpeg格式的圖片，但是不支持Png格式的圖片，只要研究一下Gif圖片和Png圖片的文件格式 (見資源文檔) ，我們可以找到其中有很多相似之處：都有一個文件頭，一個或幾個調色板，經過壓縮的數據塊。由于公司的許多游戲都要用到PngProcess.jar這個工具來處理調色板信息，所以我們寫了類似的工具GifProcess.jar，把這個工具放到PngProcess.jar所在的目錄下，接下來你所要做的工作就是：將批處理中所有提到PngProcess.jar的地方改成GifProcess.jar，將data目錄下所有Png圖片用PS的批處理功能轉成Gif圖片。不要進行optipng.exe處理。

7.       修改按鍵代碼

DoJa3.5的鍵值可以在文檔中查到，按照那個改了就可以了，需要特別說明的是，在MIDP中是通過keyPressed/keyRelease 函數響應按鍵事件, getKeyState()獲得鍵值。而在DoJa3.5中只能通過processEvent函數響應按鍵事件，getKeypadState()獲得鍵值，因此需要添加processEvent函數：

   //示例代碼

       public void processEvent(int type, int param)

       { //update by doja

              if(type == Display.KEY_PRESSED_EVENT)

              {

                     keyPressed(param);

              }

              else if(type == Display.KEY_RELEASED_EVENT)

              {

                     keyReleased(param);

              }

              else if(type == Display.RESUME_VM_EVENT)

              {

                     System.gc();                

              }

       }

對于按鍵檢測,還有一點需要注意的是,在Doja中所以按鍵處理都是通過processEvent 來響應包括左,右功能鍵以及紅鍵.

8. 修改畫圖接口

DoJa3.5中沒有drawRegion方法，也找不到一個函數能夠完全替代drawRegion的，其主要原因就在于DoJa3.5沒有anchor這個概念，并且它的翻轉方式是由專門的函數setFlipMode來決定的，我們可以從下面對MIDP和DoJa代碼的對比中得到啟示：

MIDP

cGame.g.drawRegion(cGame.mImg[img],                                           module_X(moduleID),//scrX                                           module_Y(moduleID),//scrY                                           module_W(moduleID),//w                                           module_H(moduleID),//h                                           cGame.transform[refModuleFlag],                                           __i1,//desX                                           __i2,//desY                                           __i5);

DoJa3.5

if((__i5&Graphics_RIGHT)!=0) __i1-=module_W(moduleID); cGame.g.setFlipMode(cGame.transform[refModuleFlag]);        cGame.g.drawImage(cGame.mImg[img],                                __i1, //desX __i2, //desY                                      module_X(moduleID), //scrX   module_Y(moduleID), //scrY                                      module_W(moduleID), //w module_H(moduleID)  //h                                      );

以上只是一個簡單的對比，實際操作會遇到很多復雜的東西，比如說DoJa3.5沒有TRANS_MIRROR_ROT90和TRANS_MIRROR_ROT270兩種翻轉模式，如果游戲中要用到就自己實現這些功能吧。

9.       修改聲音的相關接口

MIDP中是通過Player接口和Manager類來控制和播放聲音。DoJa3.5中要用到是AudioPresenter和MediaSound類和MediaListener接口，還有就是Doja只支持mld音樂文件格式。我們可以從下面的這段代碼中知道建立聲音數組和播放控制的一般方法：

//示例代碼

static com.nttdocomo.ui.AudioPresenter[]           _musics;

_musics = new com.nttdocomo.ui.AudioPresenter [BGM_MAX];

MediaSound m_sound;

boolean         isPlaying = false;

      // Event Listener (manages playback state)

      public void mediaAction(MediaPresenter source, int type, int param) {

         if (type == AudioPresenter.AUDIO_PLAYING) {

              isPlaying = true;

         } else if (type == AudioPresenter.AUDIO_COMPLETE  ||

                    type == AudioPresenter.AUDIO_STOPPED) {

            isPlaying = false;

        }

     }

     // Initialize sound

     public void initSound() {

               try {

              cGame.packOpen("/BGM.pak",index);

m_sound = MediaManager.getSound(SCRACHPAD + (cGame.prv_file_offset[3] + cGame._pack_offset[index] + cGame._pack_start));

m_sound.use();

_musics[index] = AudioPresenter.getAudioPresenter();

_musics[index].setSound(m_sound);

m_sound = null;

cGame.packClose();

         } catch (Exception e) {

             // Error handling

        }

     }

     // Play the sound depending on the current playback state

     public void playSound() {

         if (!isPlaying) {

             audio.play();

        }

     }

10.   修改設置顏色的函數setColor()

DoJa3.5中只有setColor(int c)一種方式，而沒有setColor(int r, int g, int b)這種模式，這一部分需要修改。而且N900iG是26萬色（16位）的手機，全滿的RGB值是24位的，超過了手機的顏色數，如果直接用setColor(int c)可能導致異常，正確的做法是自己寫一個DoJaSetColor()方法：

static void DoJaSetColor(int col)

{

    g.setColor(g.getColorOfRGB((col & 0xFF0000) >> 16,

  (col & 0x00FF00) >> 8,  col & 0x0000FF));

}

如果是setColor(int,int,int),方法同.

11.  背景燈光,振動

       MIDP2.0中是Display.vibrate()和Display.flashBacklight()。Doja中是通過PhoneSystem. setAttribute()來檢測開/關蓋也是通過PhoneSystem.setAttribute()檢測。具體可查API。

12. 對jam文件中AppParam屬性的說明

       我們可以通過在jam中設置AppParam參數(比如資源下載地址,版本號等),方便在程序中引用.下面我們就用個例子說明:

//示例

//jam中AppParam各個參數由空格隔開

AppParam = http://shop.ludiz.com/ato2test/jvuIgoUbc/Chessmaster_N900Gi_JP_1000 29 1.0.0

//程序中

String _launchParams[] =  cMIDlet._theMIDlet.getArgs();

String _url = _ launchParams[0];    //資源下載地址

Int spSplites = Integer.parseInt(_launchParams[1]); //spSplites = 29

string _version = _ launchParams[2];//_version = “1.0.2”