从 Android 到 Windows 的 API 映射

  • 项目

我们提供了一个 API 映射索引来帮助你找到与 Windows 运行时 API 相对应的等效 Android API，使你能够快速启动适用于 Windows 8 的开发项目。

你可以使用已有的 Android 技能和代码资源来开发完全不同的 Windows 应用商店应用。为了让 Android 开发人员轻松转换到 Windows 应用商店应用，我们提供了一个 API 映射索引。此索引将 Android API 映射（对应）到具有类似功能的相应 Windows 运行时 API。

虽然本主题重点关注 Windows 运行时 API 映射，但我们仍提供一些额外资源，以帮助你转换到 Windows 应用商店应用开发，具体包括：

关于 API 映射索引

如果你是 Android 开发人员，则 API 映射索引能够提供指引，帮助你找到 Windows 运行时开发平台上的相应内容。它可帮助你评估现有的应用，挑选出最重要的 Windows 运行时 API 调用，并快速找到 Windows 运行时中与之等效的类、方法及属性。

API 映射能够：

  • 为创建其首个 Windows 应用商店应用、且没有相关经验的 Android 开发人员提供协助。在这种情况下，此索引提供概念上的映射关系，使你能够对你已经熟悉的 Android 功能与理念加以研究和利用。
  • 通过在两个平台间映射特定功能，从而为移植现有的 Android 应用提供协助。当然，对应用进行移植通常并不足够。你应该熟悉 Windows 应用商店应用优秀设计的指南与原则，以便开发出足以脱颖而出的优秀的 Windows 应用商店应用。

如果已有 Windows 运行时 API 具有与等效的 Android API 类似的功能，则此索引会提供一个映射。此映射包括 Windows 运行时 API 参考文档的链接，以及对其使用情况进行演示的代码段链接（如果提供）。如果不存在可能的直接映射，则此索引会提供一个链接指向最相关的概念性主题，以便你能够更好地理解在这些平台之间的概念映射关系。概念性主题是进行更深层研究的起点。

API 映射索引不提供的内容

API 映射索引不会为 Android 中可用的每个功能或 API 提供完整的介绍。该 API 映射仅部分覆盖来自 Android 的一些最常用和最重要的框架。具体包含与控件、传感器、网络功能、图片及媒体（包括音频和视频）等相关的框架。将来可能会添加其他框架。

由于 Android 与 Windows 运行时在设计方面存在差异，因此，一个 API 并不总是能够映射到另一个 API。 通常而言，同一功能可以通过结合使用 Windows 运行时 API 和代码得到实现。在这些情况下，索引中不包含相关映射。

此索引并不是迁移工具，它不会自动对你的代码进行评估和移植使其在 Windows 8 上运行。API 映射的目的在于帮助你缩小对相关 API 的搜索范围。从映射的 API 开始着手时，你应确定如何实现对应的功能，以利用 Windows 8 平台来构建你的应用。

如何使用 API 映射索引

若要使用 API 映射索引，请在左侧选择一个 Android 程序包。然后选择类或接口以及方法或其他成员。如果索引包含映射，则在右侧显示对应的 Windows 运行时 API 类和方法或其他成员。此索引可让你浏览所有映射或搜索特定的映射。下面提供了一些例子：

  • 一位开发人员想查找一个 Windows 运行时 API，该 API 应提供与 Android Camera 类相似的功能。该开发人员知道此 Camera 类属于 android.hardware 程序包。他/她单击了左侧的 android.hardware，然后单击 Camera。此时将在右侧显示一个指向 Windows 运行时 MediaCapture 类 API 参考主题的链接，同时显示的还有一个指向 MediaCapture 类代码示例的链接。
  • 一位开发人员想查找一个 Windows 运行时 API，该 API 应提供与 Android File 类的 getPath 方法相似的功能。该开发人员知道此 File 类属于 java.io 程序包。他/她单击了左侧的 java.io、File、“方法”，然后单击 getPath。此时将在右侧显示指向 Windows 运行时 StorageFile、FileInformation 和 FolderInformation 类 API 参考主题的链接。
  • 一位开发人员想查找一个 Windows 运行时 API，该 API 应提供与 Android Sensor 类相似的功能。他/她在“搜索...”框中键入了 Sensor，然后单击放大镜图标。此时将显示一个 Windows 运行时 API 搜索结果列表。该开发人员单击其中一个搜索结果，此时将显示一个指向相应的等效 Windows 运行时 API 参考主题的链接。

多个 API 映射

有时，对于一个给定的 Android API，可能有多个 Windows 运行时 API 映射存在。在这种情况下，API 映射索引将显示所有可能的映射。 如果搜索结果返回了多个映射，你将需要查看对应的 API 参考主题，以确定最适合你使用的 Windows 运行时 API。

映射 API 到概念性主题

Windows 运行时是一个通用的全能开发平台。对于要实现或移植的给定 Android 应用中所找到的功能，你几乎都可实现。但是，由于编程模式的差异，可能没有一个确切的 Windows 运行时 API 与给定的 Android API 相对应。由于编程抽象的差异，与某个 Android API 类似的功能可能必须通过多个 Windows 运行时 API 来实现，或者必须通过创建你自己自定义的类或方法来实现。如果不可能映射到单个 Windows 运行时 API，API 映射索引会提供一个指向概念性主题的指针，对相应的平台功能加以阐述。

后续步骤

现在你已知道索引的用途，我们建议你试一试。此外，我们的 API 映射尚未最终成形，因此也邀请你帮助扩展我们的平台覆盖面。如果你确定某个新的 API 映射在此索引中尚不存在，请花一点时间让我们知悉。为此，请在 API 映射索引的“搜索...”框下方，单击“有遗漏？建议新的映射”****，然后按照屏幕上的指示操作。我们将审阅你的建议；如果适用，则会将它们添加到数据库中。

相关资源