Chinaunix首页 | 论坛 | 博客
  • 博客访问: 459766
  • 博文数量: 155
  • 博客积分: 2954
  • 博客等级: 少校
  • 技术积分: 1000
  • 用 户 组: 普通用户
  • 注册时间: 2010-01-12 22:00
文章分类

全部博文(155)

文章存档

2014年(2)

2013年(5)

2012年(10)

2011年(33)

2010年(105)

我的朋友

分类: Java

2010-05-17 17:00:27

一篇
如果本文的读者还不知道polish所为何物,那么请可以去j2mepolish的官方网站看下,它到底是用来干嘛的,我们这里只谈它其中的一个build功能。本人接触polish的时间也不长,可以说是小菜鸟,所以文章中难免出现问题,希望读者能够不吝指正。

        问题的提出:我们为什么要用polish来build我们的程序?其实build程序我们可以用很多IDE来完成,但是我们利用polish是为了解决一个问题,而这个问题可能同样困扰着你。由于不同手机平台的不同,而往往这些不同手机上实现程序会有一定的差异性,即使同一个平台,比如Nokia来说,它的不同型号不同机型也不尽相同,比如老40(s40E1)播放mid和新s40以及s60就很不相同,就是因为这个原因,我们在开发的过程中会先在某一款机型上实现所有的代码、所有的功能,然后适配到不同的机型中,这样一来我们是不是得到了很多这样的代码,他们有这样几个特点:

         1>都是实现了一个有戏,代码差异性不大

         2>由于平台差异,手机差异,不同机型上的代码的差异性又不相同

         好了,现在问题出来了,如果对于这些代码进行维护,哪怕只是修改其中的几张图片,你该做什么样的工作?你可能会说,把图片放到资源文件夹内,替换原来的图片,然后在每个版本里修改一定的代码,在模拟器上调试成功后,然后重新build打包,装真机测试。那么如果这样的不同机型有15款,乃至20款,你的工作量是不是相当大,而当你改完了,你又发现其实很多机型修改的内容一摸一样,而你做了好多重复累赘的工作。这个时候,你就需要polish了。

        利用polish我们可以把这些不同的版本整合到一起,让他变成一个代码体,当然了它包含了不容机型里的所有内容,当然polish有他的办法来区分他们之间的不同。这里我举个简单的例子,比如我们的游戏中存在一个背景音乐(mid),但是我们知道并不是所有的机型都支持播放mid,再具体一点,我要做的游戏里Moto C650是能播放mid的,但是Nokia-7210却不支持,这两个机型屏幕大小完全一样(FullCanvas大小不一样,主要因为moto机型无法真正全屏,屏幕上方的状态条无法除去),游戏的代码体一摸一样,7210里不能播放声音,那么我们可以用polish简单的来判断控制来区分,看下面的代码:

//#if polish.midp2
     /**//*播放音乐代码/*
//#else
    /*不播放音乐操作/*
//#endif

        简单分析一下这段代码,我们的polish做了这么一步工作--根据你的要求,提取代码,然后打包,同样它也可以提取资源文件,我们以后慢慢讨论这些问题,这里我们继续分析代码,当机型是midp2.0时,执行播放音乐代码,因为一般的2.0机型都能播放mid,如果为1.0那么我们就不播放音乐,转而执行其他的代码,这些看似C里面宏定义的代码的作用就是能根据你的控制代码,来瓜分你的代码,而且在build\real\Nokia\7210\source下看到build后的原代码,并不包含播放声音那一段,因为7210是1.0的机子。现在你猜猜moto C650的放在那里?它就放在build\real\Motorola\C650\source下面,这个过程由polish自动完成,你不用操心,当然不播放音乐的代码也不会被包含在C650的代码中。(注明:所有的目录结构都是根据eclipse)。讲到现在,你可能知道了一点polish的build功能的魅力了。

      一句话,用polish的语言,把不同的机型代码完美的整合到一起,方便我们以后管理,修改。当然同样带来的项目上的风险,有利有弊吧,看读者怎么思考这个问题了。


二篇

上一篇文章,我们大致讲了polish的一个基本应用,但我们手头上有同一个游戏不同版本的代码的时候,我们就开始利用polish进行整合,那么在利用polish之前,我们必须把环境搭配好,接下来简单的谈谈polish环境的搭建。
     1、eclipse me+jdk+wtk这是开发环境,一般移动百宝箱需要我们用wtk1.0.4,而一般我们开发可以用更高的版本wtk2.2.
     2、ant工具(ant是一个基于JAVA的自动化脚本引擎,脚本格式为XML。除了做JAVA编译相关任务外,ANT还可以通过插件实现很多应用的调用。)
     3、polish安装文件
     4、build.xml文件
     对于第一条,我想这样的文章已经很多了,我就不说了。关于ant工具,大家可以去下ant的免安装包,解压缩路径假如是E:\ant\,那么把E:\ant\bin;添加到系统环境变量中的path中就可以了。这个时候你打开cmd,敲入ant后如果提示:
Warning:   JAVA_HOME environment variable is not set.
If build fails because sun.* classes could not be found
you will need to set the JAVA_HOME environment variable
to the installation directory of java.

Buildfile: build.xml does not exist!
Build failed
则说明安装成功,警告没有可供解析的build.xml文件,这个工具到底用来干嘛的,等我们最后分析完build.xml的时候,大家就知道了。
    polish的下载安装也很简单,大家可以搜索一下,安装就可以了,笔者的安装路径是E:\JAVA\J2ME-Polish。
    接下来就是定制自己的build.xml了。笔记给出一个简单例子,并简单给出解释,希望对大家有所帮助:
    name="KalaPolish" ------------------------------------------>你的项目名称
    default="j2mepolish">
   
    --------------------------->你的polish安装路径
    --------------------------->你的wtk安装路径
   


            classname="de.enough.polish.ant.PolishTask"
        classpath="${polish.home}/import/enough-j2mepolish-build.jar:${polish.home}/import/jdom.jar:${polish.home}/import/proguard.jar:${polish.home}/yguard-lib.jar:${wtk.home}/wtklib/kenv.zip"/>

            description="Call this target first to set the OTA download-URL, e.g. ant setdeploy j2mepolish"
        >
       
   

            description="Call this target first to skip the obfuscation step, call the emulator and start the debugger, e.g. ant enableDebug j2mepolish"
        >
       
   


        description="Call this target first to skip the obfuscation step and call the emulator, e.g. ant test j2mepolish"
        >
       
   


     
   
   







        depends="init"
        description="这是build过程的控制部分."
        >
   

                    license="GPL"
            name="杀手"--------------------------->MIDlet-Name
            version="1.0.0"--------------------------->项目版本
            vendorName="Air Long(C)"--------------------------->项目供应商
            icon="/icon.png"--------------------------->项目图标
            jarName="Kala${polish.Name}.jar"
            ------>jar的名字,注意因为我们会同时打很多不同的版本,${polish.Name}来区分,“Kala”你可以自己定义
            copyright="Copyright 2007 Air Long(C). All rights reserved." --------------------->项目版权
        />
       
            --------------------------->需要打包的机型,注意机型必须在polish中有定义。
       

           
                    symbols=""
            usePolishGui="no"
            workDir="${dir.work}"
            >
           
            ----------------->MIDlet class的名字,必须正确
                            dir="res"
                defaultexcludes="yes"
                excludes="readme.txt">
                                        dir="res/Sound"
                        includes="*.bin"
                        if="polish.Identifier == Nokia/7210"
                    />--------------------------->内定义了一些具体的资源文件的应用,比如这里如果打包时候判断是Nokia/7210,那么就自动包含res/Sound文件下的*.bin文件。*为通配符,如果包含全部文件,那就是*.*。其余的几个大家自己分析一下就知道怎么用了。
                                        dir="res/Sound"
                        includes="*.bin"
                        if="polish.Identifier == Nokia/N-Gage_QD"
                    />
                                        dir="res/Sound"
                        includes="*.mid"
                        if="polish.Identifier == Nokia/7260"
                    />
                                        dir="res/Sound"
                        includes="*.mid"
                        if="polish.Identifier == Motorola/C650"
                    />
                                        dir="res/Sound"
                        includes="*.mid"
                        if="polish.Identifier == Sony-Ericsson/K506"
                    />
               
           

           
           
           
           
           
           
           
            ----------->混淆器设置,我们这里用ProGuard,wtk2.2下面的一个混淆器
           
           

               
           
               
               
                   
           

           
           
                ---------->这里定义了jad里面的信息
               
               
           

       
       
                        wait="true"
                securityDomain="trusted"
            enableProfiler="true"
            enableMemoryMonitor="true"
            enableNetworkMonitor="true"
                if="debug"
                >
               
               
           

                            wait="true"
                trace="none"
                securityDomain="trusted"
                enableProfiler="false"
                enableMemoryMonitor="false"
                enableNetworkMonitor="false"
                if="test and not debug"
                >
           
   

            name="emulator"
        depends="test,j2mepolish"
        description="invokes the emulator"
    >
   

          description="allows a clean build. You should call [ant clean] whenever you made changes to devices.xml, vendors.xml or groups.xml">
   
        ----------->clean dist文件夹下面内容功能,可以让用户删除打包文件,这点很有用,有的时候版本更新,必须先clear

            name="cleanbuild"
        description="allows a clean build. You should call [ant cleanbuild] whenever you made changes to devices.xml, vendors.xml or groups.xml"
        depends="clean, j2mepolish"
    />----------->clean build文件夹下面内容功能,可以让用户删除打包文件,这点很有用,有的时候版本更新,必须先clear

   

   
       
       
   

                description="customizes this project with the settings found in resources/customization1"
            depends="enableCustomization1, j2mepolish"
    />

   
       
       
   

                description="customizes this project with the settings found in resources/customization2"
            depends="enableCustomization2, j2mepolish"
    />


     以上红色比分,大家修改成自己的就可以了,当然,玩家也可以把打包工具改成wtk1.0.4,注意的是,无论你的打包工具,bin目录下面是否安放了混淆器,都没有关系,因为打包用的混淆器并不是利用wtk里面的混淆器,而是利用了,polish自带的混淆器,具体polish怎么解析这个build文档,大家可以看polish的原文件。有点提醒大家,混淆器的定义的时候,本文中是ProGuard,第一个字母必须大写,否则就出错,想知道问什么的,可以去看polish的代码实现中关于混淆器的代码。
     好了,把这个文档放到你的项目目录下面,就可以在eclipse中点击这个build.xml选择ant构建来打包我们的程序了。到这里我们的环境就配置好了。文章写的很粗略,希望对大家有所帮助。文章红色部分为注释,用的时候,必须删除。

三篇


有了以上两篇文章的铺垫,我想大家基本上就可以使用polish了,但在使用过程中,或许还会遇到很多问题,比如:我要打包的机型在polish中没有找到,我要用的api在polish中没有,我的手机厂商在polish中也没有,在代码中一些polish的标签如何用等等,这篇文章,我们带着这些问题,给读者解答这些问题,游戏问题解决方法很多,不是唯一的,仅供参考。
     第一类问题:我的项目中,有几个机型中用到的资源有些不一样,比如7210放不了mid,我要用Nokia提供api里的sound,所以打包的时候我不想把mid文件打包进去,而是要把data.bin文件打包进去,如何解决呢?
     答案:在我的第二篇文章里,就给出了答案,这里回顾一下:
                     dir="res"
                defaultexcludes="yes"
                excludes="readme.txt">
                                        dir="res/Sound"
                        includes="*.bin"
                        if="polish.Identifier == Nokia/7210"
                    />
      
       这段build内容我不多解释了,我想大家应该明白了,具体放在build那个位置,大家可以参考文章二。
       第二类问题:我的机型涉及到很多屏幕大小,比如有C650 128*128的,有7610 176*208的,他们用的图片文件不一样,那么在一个polish中整合后,如果让polish知道,应该用那一张图片呢?
       在将这个问题之前,我想先说明一下polish的一个机制,放在res里面的文件,表示polish打包时候不同的型号都会被包含,那么当然如果我们把不同的屏幕大小的都放在一个目录下面,打包的后的jar包含了不需要的图片,会很大,我们当然不能容忍这样的事情发生,给出几个解决方法,大家可以结合使用,效果很不错。其实在polish在给N7210打包的过程中,他会自动去寻找res目录下面Nokia目录下面的7210文件夹下面是否有内容,如果有,就会包含进去,如果在res目录下面已经有了,也会覆盖,用res/Nokia/7210下的文件来取代。当然默认环境下没有res/Nokia/7210这个目录,但你的程序N7210上有一些特别的资源的时候,不要放在其他地方,放这个目录下面就对了。接下来大家应该知道怎么做其他的机型了吧?哈哈,当然,有的人会说用问题一中的方法也会可以的,但是如果你打包的机型用到的资源不统一,你要写很长的build来进行区分了,不可取。当然,这样会有有一个问题,那就是一般同一个屏幕大小的,图片会是一样的,那么我如果用上面两个方法,就没有办法简单的根据屏幕来区分,其实polish给我们提供了一个机制,那就是根据屏幕大小来获取自由,在res下面创建一个FullCanvasSize.170+x200+目录,什么意思?一看就懂的吧,哈哈,这样你的176*208的机型的图片就会在这个文件夹下面找了,而不会包含128*128的图片了,这里给出一个例子说明可以这么做,具体效果怎么样,大家还是要自己去尝试一下的。这样利用上面的三个方法,灵活应用,自由的区分问题就可以完美解决了。
       第三类问题:如何在polish里面添加手机厂商?
       比如和你想添加一个手机厂商,比如叫XXX,那么你在polish的安装目录下面找到vendors.xml,添加如下代码就可以了:

        xxx
       

        第四类问题:如何添加手机型号?
        一样的道理,找到安装目录下面的devices.xml。稍微解释一下需要添加的代码段:
       
        Nokia/7210--------------->vendor和型号,build里面需要打包机型必须好这里一直
        Series40--------------->被分在Series40机型这个组里面,这里如果定义了这个,那么在polish中判断是否是40机型的时候,会把这个机型包含进去
        --------------->屏幕大小
       
        --------------->MIDP平台
        --------------->支持声音类型
        --------------->堆内存大小
        --------------->最大jar支持大小
       
       
       


         --------------->这个属性在7210中没有,在有些机型中有,主要是说明机型支持那些特殊的api,当然必须是polish的import目录下面有的类了。
          第四类问题:如果让polish更加强大,让它支持更多的api,比如,但我们在三星的D508上开发关于SMS的应用的时候,利用j2me自带的mmapi发送失败,我们必须利用三星自己的开发包,假如手头上我们下载了三星的开发包samsung.zip,那么如何让polish支持和呢?很简单,第一步,把开发包放到polish安装目录下面的import目录下面,然后需要注册这个api包,打开安装目录下面的apis.xml文件,添加如下内容:
    
        Samsung User Interface API--------------->名称,并不重要
        The Samsung User Interface API provides
            some advanced Message functionalities.
       
--------------->描述,也不是很很重要
        samsung-api,samsungapi--------------->我们在代码里面用的时候,就用这个名字
        samsung-api
        samsung.zip--------------->开发包名称,这个必须和import下的名字一样
        import/samsung.zip--------------->路径,也必须属性正确
   

     给个简单的例子说明如何应用吧
     //#if polish.api.samsung-api ----------------->注意这里红色部分,必须和api中定义的names一样
     import javax.wireless.messaging.*;
     //#else
     //#= import com.samsung.util.*;
     //#endif
     好了,接下来简单的介绍一些代码用到的常用标签,希望给初学者一些帮助:
     //#if polish.api.nokia-ui 判断机型是否支持nokia的开发包
     //#if polish.api.mmapi || polish.midp2 如果支持mmapi或者是2.0机型
     //#if polish.Vendor == Nokia   如果是Nokia机型
     //#if (polish.Identifier == Nokia/7210) || (polish.Identifier == Nokia/N-Gage_QD)   如果是打包Nokia/7210或者Nokia/N-Gage_QD,注意两个都必须用括号,否则会报错。
     //#if (polish.ScreenWidth < 176) 如果屏幕宽度小于176
     //#ifdef BUY_SMS 如果定义了BUY_SMS

阅读(1334) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~