j2me polish学习 - J2ME手机游戏开发站

首页

j2me polish学习

	j2me polish学习
	Author: 一滴蔚蓝色 \| Date: 2008-05-25 \| View: 858 \| 开发技术 - 程序设计 \| Digg: 0

转自: http://muscle-liu.spaces.live.com ( Muscle )

工作两差吾多两个月了, 里段时间里我都在做一个j2me项目, 项目是用到polish进行UI开发。回想起刚开始对polish的认识, 我系里度谈谈对polish噶认识。

J2ME Polish是德国人的一个开源项目，主页是：http://www.j2mepolish.org/，类似于一个java开发环境的插件。本人开发环境是：window下netbeans 5+jdk1.5+Mobility +polish 2.0 RC4。安装polish很简单，从主页下载落来双击就可以安装了，如果你的机不能运行jar文件，则可以在cmd中用 “java -jar j2mepolish-2.0.jar ”就可以运行了（前提是你安装着jdk，且环境变量设置正确）。

安装过程中，选择wtk.home和选择安装在netbeans和全部api，其他默认就可以了。安装后重启netbeans 就会自动嵌入netbeans中的了。下面我们来创建一个polish项目：

有两种方法，一是在netbeans中创建polish项目（polish自带的samples），但这要清楚samples对应要用到的api 和支持的devices(相应你要装有此device)，所以本人一般不用此方法。二是创建普通的Mobile application，然后把polish里边sample里的build.xml文件copy到工程目录下，修改<midlet /> 属性值，同时引入相应的api 包(/lib/enough-j2mepolish-build.jar 和 /lib/jdom.jar 一定要引入) 就行了。

上次介绍了一下 polish的大概。其实本人我对j2me和polish都是刚接触的，以下来我会同时介绍j2me和polish的学习心得。以下我们以一个 expenses tracker（builder.com里的一个例子）的例子来介绍建立polish项目(这个例子可以在)。

在netbeans我们可以先建立一个一般的Mobile的项目，按netbeans 向导很容易建立。这里工程expenses tracker里有两个类：

Expenses.java:

/*

Expenses

A sample J2ME MIDP application that illustrates the use

of List and Command UI components

Copyright 2002 CNet Networks

*/

package ExpensesApp;

import javax.microedition.midlet.*;

import javax.microedition.lcdui.*;

import java.util.Vector;

public class Expenses extends MIDlet implements CommandListener {

    private Display display;

    private Vector expenseItems;

    private List lsMain;

    private Command cmAdd, cmEdit, cmExit, cmMenu;

    private int itemCount = 0;

    public Expenses() {

        display = Display.getDisplay(this);

//        get some play data

        expenseItems = ExpenseInfo.LoadExpenses();

        itemCount = expenseItems.size();

//        Setup the UI

        lsMain = new List("Expenses", List.IMPLICIT) ;

        cmAdd = new Command("New", Command.SCREEN, 3);

        cmEdit = new Command("Edit", Command.ITEM, 2);

        cmExit = new Command("Exit", Command.EXIT, 1);

        lsMain.addCommand(cmAdd);

        lsMain.addCommand(cmEdit);

        lsMain.addCommand(cmExit);

        lsMain.setCommandListener(this);

//        add all the Expense items to lsMain

        rebuildList();

    }

    public void startApp() throws MIDletStateChangeException {

//        Show the main UI form

        display.setCurrent(lsMain);

    }

    public void commandAction(Command cm, Displayable d) {

        if (cm == List.SELECT_COMMAND || cm == cmEdit) {

//            User selected an item in lsMain or

//            invoked the "Edit" command from the menu

//            Edit an item, we'll implement this later

        } else if (cm == cmAdd) {

//            User invoked the "Add" command from the menu

//            Add a new item, we'll implement this later

        } else if (cm == cmExit) {

//            User invoked the "Exit" command

            destroyApp(false);

            notifyDestroyed();

        }

    }

    public void pauseApp() {

    }

    public void destroyApp(boolean b) {

    }

    private void rebuildList(){

//        add all the expense items to lsMain

        for(int i=0; i<expenseItems.size(); i++){

            if (expenseItems.elementAt(i) != null){

                ExpenseInfo exp = (ExpenseInfo) expenseItems.elementAt(i);

                lsMain.append(exp.getDescription(),null);

            }

        }

    }

}

ExpenseInfo.java:

/*

ExpenseInfo

Models an expense item for the sample Expenses

J2ME MIDP application

Copyright 2002 CNet Networks

*/

package ExpensesApp;

import java.util.Date;

import java.util.Vector;

public class ExpenseInfo {

//    Expense Item categories

    public static final String[] Categories = {"Meals","Lodging","Car","Entertain","Misc"};

    public static final int CATEGORY_MEALS = 0, CATEGORY_LODGING = 1,

    CATEGORY_CAR = 2, CATEGORY_ENTER = 3, CATEGORY_MISC = 4;

//    member variables

    private Date ExpenseDate;

    private String ExpenseDescription;

//    We don't have floating point support,

//    so we have to fake it with two int variables

//    to store the amount of the expense

    private int ExpenseDollars;

    private int ExpenseCents;

    private int ExpenseId;

    private String ExpenseCategory;

    private int ExpenseCategoryID;

    public static Vector LoadExpenses() {

//        Eventually, we'll need to load expenses from

//        the data store into this vector, but for now

//        let's just load some play data

        Vector v = new Vector();

        ExpenseInfo exp = new ExpenseInfo();

        exp.setDescription("Car Rental");

        exp.setDollars(25);

        exp.setCents(99);

        exp.setCategoryID(CATEGORY_CAR);

        v.addElement(exp);

        exp = new ExpenseInfo();

        exp.setDescription("Hotel");

        exp.setDollars(54);

        exp.setCents(00);

        exp.setCategoryID(ExpenseInfo.CATEGORY_LODGING);

        v.addElement(exp);

        exp = new ExpenseInfo();

        exp.setDescription("Dinner");

        exp.setDollars(18);

        exp.setCents(78);

        exp.setCategoryID(ExpenseInfo.CATEGORY_MEALS);

        v.addElement(exp);

        return v;

    }

    public ExpenseInfo(){

        ExpenseDate = new Date();

        ExpenseDescription = "";

        ExpenseDollars = 0;

        ExpenseCents = 0;

        ExpenseCategoryID = ExpenseInfo.CATEGORY_MISC;

    }

    public void save() {

//        mock saving data by printing to the console

        System.out.println (ExpenseDate.toString() + " " + ExpenseDescription

                + " $" + String.valueOf(ExpenseDollars) + "." + String.valueOf(ExpenseCents));

    }

//    The rest of these are simply accessor methods

//    for the class's private fields.

    public void setDate(Date newDate){

        ExpenseDate = newDate;

    }

    public Date getDate(){

        return ExpenseDate;

    }

    public void setDescription(String newDescription){

        ExpenseDescription = newDescription;

    }

    public String getDescription(){

        return ExpenseDescription;

    }

    public void setDollars(int newDollars){

        ExpenseDollars = newDollars;

    }

    public int getDollars(){

        return ExpenseDollars;

    }

    public void setCents(int newCents){

        ExpenseCents = newCents;

    }

    public int getCents() {

        return ExpenseCents;

    }

    public String getCategory(){

        return ExpenseCategory;

    }

    public int getCategoryID(){

        return ExpenseCategoryID;

    }

    public void setCategoryID(int newID){

        ExpenseCategoryID = newID;

        ExpenseCategory = Categories[newID];

    }

}

运行此工程如下：

现在我们来让这个工程变为polish工程：

我们可以把{polish.home}/sample/blank里的blank例子里的全部文件copy到expenses tracker 工程下，然后把原来expenses tracker工程文件夹下的src文件夹移入source文件夹里。把build-netbeans.xml改名为build.xml替换旧的 build.xml文件。

然后我们来修改build.xml: 1）、工程名可以可以改为
ExpensesTracker, <j2mepolish></j2mepolish>中的<info> jarName可改为： jarName="${polish.vendor}-${polish.name}-${polish.locale}-ExpensesTracker.jar" （这是生成的jar和jad的名称，你也可以不改）。

2）、把全部<deviceRequirements> 注释掉改为：

这里你可以把value值改为你想显示的模拟器，但是模拟器要安装在你机上，且polish支持（可以查看{polish.home}里的devices.xml文件看polish是否支持）。

3）、<midlet />属性改为你工程的midlet类本例子如下：
<midlet class="ExpensesApp.ExpenseInfo" name="ExpenseInfo" />

4）、引入{polish.home}/import/enough-j2mepolish-client.jar；

（注：我们也可以不用建立工程，直接把blank工程copy到你的工程目录下，然后把你的旧工程代码src目录放入cource文件夹，然后按上边的修改后在netbeans打开工程就可以了。）

现在就可以运行程序看看效果：

现在我们来说说上边的ExpensesTracker里边用到的j2me知识，同时我会介绍polish，通过polish来美化 ExpensesTracker。我会从j2me基本的GUI（主要是javax.microedition.lcdui;类）编程，然后会讨论j2me 里的数据存储。

ExpensesTracker 程序里边由一个单独的MIDlet(Expenses)和一个数据类(ExpenseInfo)组成。Expenses提供了简单的UI，而 ExpenseInfo则定义了数据的结构（fields for data and time, description, amount, and category ）。因为lcdc1.0是不支持floating-point数据的（lcdc1.1支持），所在在ExpenseInfo里用两个独立的int 来记录expense amount的dollars和cents。

基本UI：

从上边工程运行的效果来看，Expenses UI 由一个List 组件（显示了你记录了的Expense条目）和三个Command 组件（quitting the app, editing an item, adding a new item）组成。

List是继承Screen类而来的，在j2me中的List组件其有三种类型：

· Implicit Lists (Expenses里是用此类型) ：允许只能选择一个item, 当你选择某个item时会触发commandAction 事件。

· Exclusive Lists（单选）：以radio按钮形式显示，一次只能选择一个item，选择时不会触发commandAction 事件。

· Multiple Lists（多选）：以check boxes 按钮形式显示，允许多选，选择时不会触发commandAction事件。

当用户选择之后，可以通过下面的方法返回选定的索引值：

getSelectedIndex()--------返回List中一个选定项的索引值。

Polish工程项目的编译，运行，打包等等，是由build.xml文件控制的。下边是ExpensesTracker工程里的build.xml：

<taskdef name="j2mepolish"
        classname="de.enough.polish.ant.PolishTask"
        classpath="${polish.home}/lib/enough-j2mepolish-build.jar:${polish.home}/lib/jdom.jar"
    />
    
    <target name="j2mepolish-init"
            depends="init"
        >
          <property name="test" value="false" />
          <property name="customization" value="" />
        <property name="dir.work" value="build/real/${customization}" />
        <property name="dir.dist" value="dist/${customization}" />
        <property name="deploy-url" value="" />
    </target>
    
    
    
    
    
    
    
    <target name="j2mepolish"
            depends="j2mepolish-init"
            description="This is the controller for the J2ME build process."
            >
        <j2mepolish>
            
            <info copyright="Copyright 2006, 2007 Your Company. All rights reserved."
                description="Please describe me."
                infoUrl="http://www.j2mepolish.org"
                jarName="${polish.vendor}-${polish.name}-${polish.locale}-ExpenseTracker.jar"
                jarUrl="${deploy-url}${polish.jarName}"
                name="ExpenseTracker"
                vendorName="Enough Software"
                version="1.0.0"
            />
            
                        <deviceRequirements if="config.active:defined and (test or enableCompilerMode)" >
                            <requirement name="Identifier" value="${config.active}" />
                        </deviceRequirements>
                        <deviceRequirements if="device:defined and (test or enableCompilerMode)" unless="config.active:defined">
                            <requirement name="Identifier" value="${device}" />
                        </deviceRequirements>
                        <deviceRequirements unless="test or enableCompilerMode">
                            <requirement name="Identifier" value="${devices}" />
                        </deviceRequirements>
            
            <build fullscreen="menu"
                    symbols="polish.skipArgumentCheck"
                    usePolishGui="true"
                    workDir="${dir.work}"
                    destDir="${dir.dist}"
                >
                
                
                <midlets definition="${manifest.midlets}" if="manifest.midlets:defined" />
                <midlets unless="manifest.midlets:defined">
                    <midlet class="ExpensesApp.Expenses" name="ExpensesTracker" />
                </midlets>
                
                <variables>
                    
                </variables>
                
                <resources
                    dir="resources/base"
                    defaultexcludes="yes"
                    excludes="readme.txt"
                >
                    <root dir="resources/base/images" />
                    <root dir="resources/base/sounds" />
                    <root dir="resources/${customization}" if="build.${customization}" />
                    <root dir="resources/${customization}/images" if="build.${customization}" />
                    <root dir="resources/${customization}/sounds" if="build.${customization}" />
                    
                </resources>
                
                <obfuscator name="ProGuard" unless="test" >
                    
                </obfuscator>
                
                <debug if="test" showLogOnError="true" verbose="true" level="error">
                    <filter pattern="de.enough.polish.example.*" level="debug" />
                    <filter pattern="de.enough.polish.ui.*" level="warn" />
                    
                </debug>
                
                <jad>
                    <attribute name="Nokia-MIDlet-Category" value="Game" if="polish.group.Series40" />
                </jad>
            </build>
            
            <emulator
                wait="true"
                trace="none"
                securityDomain="trusted"
                enableProfiler="false"
                enableMemoryMonitor="false"
                enableNetworkMonitor="false"
                if="test and not debug"
                >
                
            </emulator>
            <emulator
                wait="true"
                securityDomain="trusted"
                enableProfiler="false"
                enableMemoryMonitor="false"
                enableNetworkMonitor="false"
                if="debug"
                >
                
                <debugger name="antcall" target="connect-debugger" port="6001" />
            </emulator>
        </j2mepolish>
    </target>
    <target name="setdeploy"
        description="Call this target first to set the OTA download-URL, e.g. ant setdeploy j2mepolish"
        >
        <property name="deploy-url" value="http://www.company.com/download/" />
    </target>
    <target name="enableDebug"
        description="Call this target first to skip the obfuscation step, call the emulator and start the debugger, e.g. ant enableDebug j2mepolish"
        >
        <property name="debug" value="true" />
    </target>
    <target name="enableEmulator"
        description="Call this target first to skip the obfuscation step and call the emulator, e.g. ant test j2mepolish"
        >
        <property name="test" value="true" />
        <property name="dir.work" value="build/test" />
    </target>
    <target
        name="emulator"
        depends="enableEmulator,j2mepolish"
        description="invokes the emulator"
    >
    </target>

<target name="run"
                    depends="enableEmulator, j2mepolish"
            >
            </target>

build.xml文件中最主要的是<info>，<deviceRequirements>和<build>三部分。

其中<info>元素指定说明了工程中的一般信息，如，工程名和版本。<deviceRequirements> 元素是用来指定程序编译时所选择的模拟器。<build>元素是工程编译构件时的主要控制器（如，可以设定属性 usePolishGui=”true”来指定把polish应用当前工程中，而设为false时，则说明当前工程不引入polish，此时工程与一般的 mobile应用程序一样）。

当build.xml文件中的<build>属性usePolishGui=”true”时，我们就可以修改工程目录中 resources里的polish.css文件控制程序的显示(美化j2me介面)。在j2me程序中只需要以“//#style”指令就可以调用相应的css属性(请注意这指令与注释“//”的区别)。其中，polish.css文件包含对应用程序的全部items和screens的style定义。

polish.css文件中常用的预定义的style（用于程序中的所有items和screens，但当引用自定义style时，预定义的style会被自定义style覆盖掉：

colors{}：用来定义一系列的颜色，供其它style中的color属性引用。

backgrounds{}：用来定义一系列的背景，供其它style中的background属性引用。

borders{}：用来定义一系列的边框，供其它style中的border属性引用。

focused{}：当获取某个item或screen的焦点时的style。

title{}：应用于所以screen中的title的style。

scrollbar{}：当build.xml文件中“polish.useScrollBar“变量设为true时被scrollbar引用。

label{}：应用于所以item或menu中标签的style。

以下style是当build.xml文件中“polish.MenuBar.useExtendMenuBar“变量设为true时被引用的：

menubar{}， menu{}，menuItem{}，leftcommand{}，rightcommand{}

polish.css文件中自定义style：

注意：styel可以继承的，且引用子style时既保留父style的属性又有自己的属性，同时子style可以重写父style属性。

自定义style名称：如“.mystyle{}”是由点加字符串。注意不能是与预定义的名称相同。

下面我们来对ExpensesTracker中的UI---List以CSS进行修改。

修改后程序运行如下：

其polish.css文件：

colors {
    fontColor: rgb( 30, 85, 86 );
    focusedFontColor: #000;
    bgColor: #eee;
    focusedBgColor: #fff;
    borderColor: fontColor;
    focusedBorderColor: focusedFontColor;
}

focused {
    margin: 1;
    margin: 3;
    background {
        type: round-rect;
        arc: 4;
        color: focusedBgColor;
        border-color: focusedBorderColor;
        border-width: 2;
    }
    font {
        style: bold;
        color: focusedFontColor;
        size: small;
    }
    layout: expand;
}

/**
* The title style is a predefined style which is used
* for all screen-titles.
*/
title {
    padding: 2;
    font-face: proportional;
    font-size: large;
    font-style: bold;
    font-color: focusedFontColor;
    border: none;
        background {
            type: vertical-gradient;
            top-color: #fff;
            bottom-color: rgb(140,206,220);
            start: 10%;
            end: 90%;
        }
       layout: expand|center;
}
.expenseList{
    background {
       image:url(BG.png);
       color: rgb(184,235,246)
     }
}
.expenseItem{
        margin: 3;
        padding-left: 3;
        font-face: proportional;
    font-size: small;
    font-style: bold;
    font-color: focusedFontColor;
        focused-style: expenseItemFocused;
}
.expenseItemFocused extends .expenseItem{
        background-color: argb( 150, 255, 255, 255 );
        after: url(listItem.png);
        layout:expand;
}

而Expenses.java中引用CSS的地方(绿色字体)：

public Expenses() {
        display = Display.getDisplay(this);
        //get some play data
        expenseItems = ExpenseInfo.LoadExpenses();
        itemCount = expenseItems.size();
        //Setup the UI
       //#style expenseList
        lsMain = new List("Expenses", List.IMPLICIT) ;
        cmAdd = new Command("New", Command.SCREEN, 3);
        cmEdit = new Command("Edit", Command.ITEM, 2);
        cmExit = new Command("Exit", Command.EXIT, 1);
        lsMain.addCommand(cmAdd);
        lsMain.addCommand(cmEdit);
        lsMain.addCommand(cmExit);

        lsMain.setCommandListener(this);
        //add all the Expense items to lsMain
        rebuildList();
    }

private void rebuildList(){
        //add all the expense items to lsMain
        for(int i=0; i<expenseItems.size(); i++){
            if (expenseItems.elementAt(i) != null){
                ExpenseInfo exp = (ExpenseInfo) expenseItems.elementAt(i);
                //#style expenseItem
                lsMain.append(exp.getDescription(),null);
            }
        }
    }

更多阅读:

尚无评论发表

我要发表评论

上一篇: 封装MathFP和FloatBox

下一篇: J2ME float 处理

登录菜单

订阅本站

J2ME手机游戏开发站

登录菜单

最新文章

本月热门

订阅本站