 |
在几分钟内开始你的
Eclipse移动开发之旅 |
从旧版EclipseME移植到新版本
该页面将指导你如何从EclipseME工程从早期的版本移植到新版本。 除了某些特定的情况，EclipseME会自动完成这些步骤。
向1.5.0版本移植
从早期版本移植到1.5.0需要进行手工调整，参见 向1.5.0版本移植的指导 一节来获得完整的相关信息。
向1.2.3版本移植
向1.2.3版本移植是自动完成的。 按照以下步骤可以完成移植：
- 打开所有你想进行移植的工程
- 退出Eclipse
- 更新EclipseME .
- 启动Eclipse
- 让Eclipse完全启动
- 退出Eclipse
向1.0.0版本移植
0.9.4 以及更新的版本向1.0.0 移植是自动的。
向0.9.4版本移植
对大多数用户来说, 从 0.5.0 以及更新的版本向 0.9.4 移植是自动的。 不过0.9.4存在一个改动，使得拥有多个连接在一起的EclipseME工程的用户会碰到一些麻烦。
"中断改动" - 归因于Java构建路径选项的专家设定Export Settings of Java Build Path are now honored
背景
在老版本中，如果你的EclipseME工程引入了一个外部的包或者需要依赖另外一个EclipseME工程， 构建环境会对它们进行递归的引用。JAR包中的内容或者依赖工程的编译输出都必须经过预校验后 放到当前工程的"verified"文件夹中。当构建的时候，这些经过预校验的资源会被包含到发布出来的 包中。最后，对于Ant的用户而言，生成的Ant构建脚本中也将会包含这些由EclipseME生成的资源。
从技术上讲，这种行为不符合Eclipse标准。按照Eclipse的标准，只有导出时需要导入其他工程时 才会构成依赖。在使用工程内部的而不是其他项目内的单元测试代码或者其他资源是允许的。
为了从工程中导出资源，可以使用"Java Build Path"选项分支的"Order and Export"选项。
在这个简单的工程中， "MyMidlet/src" 被选中。于是,MyMidlet的src目录中的所有资源被预校验后将 被拷贝到依赖它的项目中。
再来看一个复杂一点的工程。 它包含了一个外部的JAR文件。这个文件即可以放在存放工程文件的区域，也可以存放在其他路径下。 将这个JAR添加进来以后，你就会在工程属性中"Java Build Path"的"Libraries"选项中看到它。
默认情况下，当你为工程添加了一个jar包的时候，这个包不会自动的被添加到工程的输出条目中去。 如下图所示：
在0.9.4版本之前， "mmapi.jar"中的所有资源会 自动的进行预校核并 被添加到诸如"MyMidlet"之类对它有依赖的包。
在改动以后，将以java构建路径选项下的"export"选项框为准。 这意味着，jar文件和依赖的工程如果没有被显式的选中要求导出，那它不会被预校验以及部署到发布文件中去。 它也不会被添加到依赖该工程的工程中去。 最后，输出的Ant构建文件也被设置成以导出选项为准。
对你来说这意味着什么?
- 如果你的EclipseME工程没有包含在发布时需要部署到你的JAR文件中去的外部扩展JAR包， 也没有依赖什么工程，那么这个改动对你没有任何影响，你不需要进行任何改变。
- 如果你的EclipseME工程包含了一个需要发布到部署JAR文件的外部JAR文件，你必须选中"Exports and Order" 选项页上该外部JAR项目的旁的选择框。如果你没有这么做，那么该JAR文件中的内容不会被预校验和部署。
- 如果你的EclipseME工程依赖了另外一个工程，那么你必须检查被依赖工程的导出选项是否设置正确。
EclipseME的开发者对移植中将会产生的一些麻烦表示抱歉。不过为了以后能够让EclipseME更好的工作， 对于使用0.9.4之前版本并且使用了外部包或者依赖工程的用户造成一些临时的麻烦还是值得的。 特别是当用户引进外部JAR文件的时候，可以更加完全更加方便的模拟一个特定设备环境。
向0.9.2版本移植
从 0.5.0以后的版本向 0.9.2 版本移植是自动的。
Migrating to Version 0.9.0
从 0.5.0以后的版本向0.9.0版本移植是自动的。
Migrating to Version 0.7.5
从0.5.0以后的版本向0.7.5移植是自动的。
注意：0.5.0版本之前的发行版本不支持自动向0.7.5移植。所以早期版本的用户向 0.7.5以后版本移植必须手动调整。
向0.7.0版本移植
向0.7.0版本移植是自动的。
注意：因为0.7.0版本增加了MIDlet签署功能，所以EclipseME的元数据(metadata)
格式发生了改变。因而被移植到0.7.0的版本不能回退到0.6.1之前版本。
向0.6.1版本移植
向0.6.1版本移植是自动的。
向0.6.0版本移植
向0.6.0版本移植是自动的。
向0.5.5版本移植
向0.5.5版本移植基本上是自动的, 只有一点需要注意：
按照RFE 1001717,原来基本java首选项 中的"资源"路径选项被去掉了。 如果你原来在这里配置了你的资源目录, 你有两种选择:
- 去掉资源目录，并且把资源全部拷贝到现有的源代码路径中。
- 你可以将你的资源目录指定成一个额外的源代码目录。 在FAQ中有如何创建一个额外的源代码目录的描述。
向0.5.0版本移植
向0.5.5版本移植基本上是自动的, 不过为了让移植线程工作你要遵循一下步骤：
- 关闭Eclipse
- 移除原来安装的EclipseME插件
- 将0.5.0版本解压到你的Eclipse安装目录。该压缩文件必须解压到Eclipse的根目录 而不是它的插件目录。
- 重启Eclipse
- 选择并执行一下选项 Project -> Clean... All
最后一步非常重要。大多数的移植工作都在工程的第一次构建时完成。在执行清除(clean) 操作之前要确定所有的EclipseME工程都打开了。在移植期间，每个工程的".project"和".classpath" 文件都将被升级以适应插件的新构架。这些文件需要保存到版本控制系统中。
关于安装的更多信息，请参见 安装指导。
向0.4.5版本移植
不必移植
向0.4.0版本移植
不必移植
向0.3.5版本移植
不必移植
向0.3.0版本移植
平台组件视图现在J2ME首选项中
在EclipseME的0.3.0版本中,平台组件视图功能被移到J2ME首选项中。 在打开包含平台组件的透视图中这会导致一些错误，它期望你检查关于Eclipse 不能恢复层的错误。选择"ok"会恢复一个不包含平台组件视图的透视图。 这个错误只出现一次。
为了避免错误, 在升级到EclipseME 0.3.0 之前 .
关闭平台组件视图就可以了。平台定义存储
在Eclipse的版本里，平台定义被保存在一个工程属性中。这个属性不能放到版本控制系统 也不能在其他机器上使用。在该版本中，如果这个属性被发现，它会自动的把它移植到".eclipseme" 文件中。这个文件可以放到版本控制系统也可以被移到其他机器上而不会出错
从classpath变量移植到classpath容器
在早些的EclipseME版本中，对于每个MIDlet套件，平台的的每个库都作为构建路径中的一个单独条目， 这些条目是基于每种无线工具包的环境变量定义，项目一旦创建就很难修改。
这一版引入了classpath容器的机制来保存源自于选定平台定义的构建路径库。 在下面截图中，MIDlet套件当前与Sony Ericsson MIDP 1.0平台定义相联系。
第一次从J2ME项目属性调整MIDlet平台定义的时候， EclipseME会在工程内创建所需的classpath容器。 这时项目中任何作为平台定义一部分的单独的classpath条目都应该被删除。 很有可能在此次移植后某些单独的条目仍保留着。这些条目应该被手动删除以避免在未来带来问题。
向0.1.0版本移植
早期版本的EclipseME创建的JAD文件格式有错误。 0.1.0修正了错误格式， 在移植的时候也会自动的更正MIDlet套件JAD文件的错误。