MOTODEV Studio for Android 安装 注意
ECCN 5D002.a
MOTODEV Studio for Android 发行说明
适用于 MOTODEV Studio for Android? 2.0 版本
为了您的方便，该文件被翻译成其它非英文语言。但是，与英文版本相比，内容有可能已过时。如有必要，请参考原英文版本。
MOTODEV Studio for Android 为开发 Android 应用程序提供了无比便利的工作流程和独特的综合体验。只需一个安装程序即可完成所有流程：从围绕 Motorola 品牌产品的设计到开发再到在 Android 手机上部署，最后到销售。
MOTODEV Studio for Android 支持为所有使用Android操作系统的手机开发应用（包括Motorola的产品和其它手机制造商的产品）。系统版本包括 Android 1.1、1.5 ("Cupcake")、1.6 ("Donut")、2.0/2.0.1/2.1 ("Eclair") 和 2.2 ("Froyo") 版本、以及OPhone SDK 1.5 和 2.0 版本。
MOTODEV Studio 基于以下技术：
?????????????????????????????? Eclipse Platform 3.6.0 (Helios)
?????????????????????????????? Eclipse Java Development Tools (JDT) 3.6.0
?????????????????????????????? Google Android Development Toolkit (ADT) 0.9.9
安装
请参阅安装 MOTODEV Studio for Android 了解已测试的配置和完整的安装说明。安装和使用 MOTODEV Studio 之前，请仔细阅读安装指南以及这些发行说明。
2.0 版本中的新增功能
?????????????????????????????? 新增多个语言包，MOTODEV Studio现在可以在简体中文，西班牙语，巴西葡萄牙语界面下运行。
?????????????????????????????? 可以查询代码段
?????????????????????????????? 新增三个Activity 模板 (图片选择列表，单选列表，多选列表)，而且所有的列表Activity模板被归于"List Activities"组下。
?????????????????????????????? 新增的 MOTODEV App Validator (应用程序验证器，beta版)使用了一个验证框架，可以检查常用错误和保证您的应用可以在不同的生产商的Android手机上运行。在这个版本上，只执行了基本的检查和验证；更为高级的检查会随着应用升级在将来的版本添加。
已知问题
以下是已知存在于此 MOTODEV Studio for Android 发行版的问题。
MOTODEV Studio for Android 包含一些并非由 Motorola 开发的 Eclipse 插件，如 ADT (Android Development Tools)，是由 Google 开发的 Eclipse 插件。MOTODEV Studio for Android 开发团队对上述插件不负任何责任，且不提供任何支持。上述插件的功能中出现的任何问题应直接报告给插件创建者。
MOTODEV Studio for Android 安装和更新问题
?????????????????????????????? 在2.0版本中，MOTODEV Studio for Android不支持开发JIL Widget。如果您想用MOTODEV Studio for Android开发JIL Widget的话，可以使用MOTODEV Studio for Android 1.3。请注意现在MOTODEV Studio for Android版本1.3和2.0可以被装到同一台计算机上，只要让它们使用不同的Workspace而且不要同时运行即可。
?????????????????????????????? MOTODEV Studio for Android 2.0版本没有在64位的Windows XP和Fedora Linux上测试过。
?????????????????????????????? 如果在作为插件安装MOTODEV Studio for Android到已经存在的Eclipse的时候，没有选择MOTODEV Application Validator（应用验证器），Validator还是会被安装，但是由于Eclipse P2的BUG，在升级的时候它不会被发现。为了能得到正常的升级，在作为插件安装MOTODEV Studio for Android的时候请选中Application Validator。
?????????????????????????????? 此版本的 MOTODEV Studio for Android 是基于 Eclipse Helios (3.6.0)。安装为插件时，您不能在旧版本的 Eclipse（ MOTODEV Studio）上进行安装，如 Eclipse Galileo。另请注意，MOTODEV Studio for Android 安装为插件时，只可将其安装在兼容的基础产品上，如 Eclipse Classic 或 Eclipse Pulsar。MOTODEV Studio for Android 插件无法安装到现有 MOTODEV Studio 中，如 MOTODEV Studio for Java ME。
?????????????????????????????? 将 MOTODEV Studio for Android 作为插件安装到现有 Eclipse 安装中之前，如果您已安装了 Google 的 ADT 插件版本早于v0.9.9，请将其卸载。MOTODEV Studio for Android 插件会从 Google 下载并安装最新的 ADT，现有安装可能会与早期版本的ADT相冲突。 如需有关卸载 ADT 插件的说明，请参阅 Google 在线文档中的 卸载 ADT 插件。
?????????????????????????????? 在Windows7上，MOTODEV Studio（或者是它基于的Eclipse）在由于某些原因（例如安装了新的组件）重启的时候可能会停止工作。如果发生这种情况，手动的关闭MOTODEV Studio（或者是Eclipse），并且重新启动。
?????????????????????????????? 如果您打开了使用以前版本的 MOTODEV Studio for Android 创建的工作区，则会显示一个错误对话框，说明找不到特定视图。这是因为 2.0 版本中更改了视图 ID。如果出现此情况，只需重置透视图（从窗口菜单中选择重置透视图）。
?????????????????????????????? 在 64 位 Windows 环境中安装 64 位版本的 MOTODEV Studio 时，安装程序会出现一些问题：
注意，这些问题只会影响安装；安装完成后，64 位版本的 MOTODEV Studio 将按预期运行。
?????????????????????????????? ?
?????????????????????????????????????????????????????? 安装程序可能无法自动检测 64 位版本的 Java。如果是这样，您需要手动指定包含 64 位版本 Java 的文件夹。
?????????????????????????????????????????????????????? 默认安装文件夹为“(…) Program Files (x86)”，如同它是一个 32 位应用程序一样。
?????????????????????????????? MOTODEV Studio for Android 安装程序确定安装于计算机上的 JVM（如有）。如果找到了多个 JVM，则仅向用户显示找到的第一个 JVM，这可能是也可能不是 MOTODEV Studio 实际使用的 JVM。
?????????????????????????????? 在 Linux 主机上，安装结束后，桌面快捷方式 可能会显示为错误的图标。快捷方式在没有执行权限的情况下创建时会出现上述问题。授予快捷方式执行权限或尝试使用快捷方式启动 MOTODEV Studio for Android，如系统询问，则指明您信任此快捷方式。
?????????????????????????????? 在 Microsoft Windows 上更新 Android SDK 时，可能会显示以下任一消息：
-= 警告！=- 文件夹无法重命名或移动。在 Windows 上，这通常表示某一程序正在使用该文件夹（例如，Windows Explorer 或您的防病毒软件）。请暂时停用...
更新程序正尝试更新 MOTODEV Studio 安装文件夹中的 SDK（虽然它可能不是您认为要更新的 SDK）删除 MOTODEV Studio 安装文件夹中的 SDK，然后重新运行更新程序。
?????????????????????????????? 如果在下载新组件或者是升级过程中发生了错误（例如网络中断），有些时候被毁坏的不完整文件仍然会保留在缓存中。如果发生了这种情况，那么尝试重新下载或是升级同样的组件会失败。如果反复出现下载或是升级失败，请清空安装目录/p2/org.eclipse.equinox.p2.core/cache中的内容并且重新尝试
项目创建问题
?????????????????????????????? 创建新的 Android 项目时，如果您清除了使用默认位置选项，则无法在您的工作区内指定项目位置。要在当前工作区内创建项目，请选择使用默认位置。否则，请指定当前工作区之外的位置。
?????????????????????????????? 创建项目时，如果您指定的路径中的父文件夹不存在，则会显示错误。例如，如果您指定路径 C:\temp\projects\myproject 且 项目 目录不存在，则会出现此问题。在父文件夹中创建项目之前，请确保该文件夹是存在的。
?????????????????????????????? 在“新建项目”向导中，随着您的编辑，会自动生成项目名称字段项目位置字段。 某些情况下，此字段不会按预期生成。
?????????????????????????????? 如果您使用 AVD Manager 安装新的程序包，然后尝试创建项目，则可能无法看到可用的目标。 如果出现此问题，请重新打开 AVD Manager（窗口 > Android SDK 和 AVD Manager），然后将其关闭。“新建项目”向导此时可以正常运行。
?????????????????????????????? 如果您的项目名称以数字开头且您使用的是向导创建的默认程序包名称，则生成的 APK 将无效。生成默认程序包名称时，向导会使用一个下划线 ("_") 字符替换项目名称中的开头数字；因为程序包名称部分必须以字母开头，这才能得到有效的程序包名称。确保您的项目名称未以数字开头，或更改程序包名称，以得 到有效名称。
本地化文件编辑器问题
?????????????????????????????? 主机上未提供“突出显示更改”选项。
?????????????????????????????? “突出显示更改”选项启用后，不会突出显示仅更改注释的单元格。
?????????????????????????????? 因为翻译功能是依赖第三方服务来进行文本翻译，因此并不保证 HTML 标记或行尾字符会保留在翻译中。务必检查结果字符串，以确保翻译恰当，且 HTML 标记或行尾字符正确放置。
?????????????????????????????? 本地化文件编辑器不会验证 HTML 标记是否一致。错误的 HTML 标记将在创建时出现。
?????????????????????????????? 对 < 和 > 进行反转义，以支持 HTML 标记。在Java 1.5 上，如果您手动输入上述任一标记作为文本，它们将分别反转义成 < 和 >。这个问题在Java 1.6上被修复了。
?????????????????????????????? 在 Microsoft Windows 主机上，“扩展行尺寸”选项可能无法生效，除非您关闭并重新打开本地化文件编辑器。
?????????????????????????????? “扩展行尺寸”选项启用后，所有行的尺寸会调整到最高单元格中行的高度。
?????????????????????????????? 单击一个多行单元格而不对其做任何更改，有时会使本地化文件编辑器指示单元格内容已被修改。不管此错误的状态指示为何，保存操作都不会更改基础本地化文件的内容。
?????????????????????????????? 如果您在编辑注释时将鼠标移出注释窗口区域，则注释窗口将会消失。
?????????????????????????????? 撤消/恢复对注释的更改无效。
?????????????????????????????? 正在编辑的文件在 MOTODEV Studio for Android 之外使用编辑器（如 Notepad）进行更改时，本地化文件编辑器不会发出警告。 在 MOTODEV Studio 内使用其它编辑器（如文本编辑器或 XML 编辑器）时，将会发出警告。
安装、运行或调试应用程序时的问题
?????????????????????????????? 如果您尝试将程序包安装到某一（实际或模拟）设备时选择了“首先卸载”选项，且您的 SDK 中没有该设备的平台，则会出现错误。 在安装新程序包之前，您必须下载对应于该设备的平台或卸载设备上的现有程序包。
?????????????????????????????? 使用 1.6 SDK 时，有时会在安装程序包时出现错误消息：
执行操作时出现错误。执行结果：- exec '/system/bin/sh' failed: Bad address (14)
如果您再试一次，可能会有效。
?????????????????????????????? 在 1.6 版本的目标上执行应用程序时，有时会出现以下错误：
请等待 3 秒后再重新尝试。
ActivityManager：错误：Activityclass {XXX} 不存在。
如果您得到此错误，则清理项目，然后重新运行应用程序。
?????????????????????????????? 使用 MOTODEV Studio for Android 启动或调试应用程序时如果有一个手机以及一个或多个 AVD 在线，则会显示一个标准的 ADT 设备选择对话框，要求您选择一个目标设备。只需再次选择所需的目标设备即可。
?????????????????????????????? 此时，您无法通过 DeviceAnywhere Studio 在远程设备上进行可靠的调试。
?????????????????????????????? 如果您使用的是 Android SDK 的调试类中的 waitForDebugger() 方法，当您运行该应用程序时，将自动创建新的调试配置，并且将使用此配置启动调试会话。此新配置将列于其它调试配置中，并可用于后面的调试会话。
?????????????????????????????? 如果您在模拟器启动时尝试运行应用程序（在手机或模拟器上），ADT 可能会崩溃，显示“空指针”消息。避免在模拟器启动时启动应用程序。
模拟器问题
?????????????????????????????? 在某些版本的 Linux 上，您关闭了 Android Emulator 视图后，运行的模拟器会终止：您无法选择保持其在背景中运行。已添加了一个新的首选项（MOTODEV Studio > Android 模拟器）来处理此问题。清除关闭 Emulator 视图后在外部显示模拟器选项，您关闭 Android Emulator 视图后，模拟器将在背景中保持运行（不可见）。重新打开 Android Emulator 视图将使您再次获得访问运行的模拟器的权限。
?????????????????????????????? 某些情况下，按窗口调整大小选项（在缩放菜单中）会使模拟器闪烁。如果遇到此问题，请更改并恢复缩放比例。例如，放大，然后再次缩小至原尺寸。
?????????????????????????????? 在某些情况下，用于将 Android 模拟器显示为 MOTODEV Studio 内的视图的本机解决方案无法在打开视图中显示模拟器。如果出现此问题，在外部窗口中使用模拟器或选择 AVD 属性中的使用 VNC 在 Eclipse 视图内显示模拟器 选项。
?????????????????????????????? 如果您的 Linux 开发计算机具有多个显示器，则注意，Android 模拟器必须显示于显示器 0 上。 尝试在其它显示器上显示时，模拟器会崩溃。
?????????????????????????????? 在 Linux 主机上，为了使用主机的键盘与模拟器进行交互，焦点必须位于模拟器选项卡上。 如果您单击模拟器屏幕，则键盘交互将无效，即使焦点出现在此处也是如此。单击选项卡（或在视