迁移现有的 Windows 应用程序

概述

要迁移使用 IBM MobileFirst™ Platform Foundation V6.2.0 或更高版本创建的现有本机 Windows 项目，必须修改此项目以使用当前版本中的 SDK。 然后，替换 V8.0 中停用或不包含的客户端 API。 迁移辅助工具可扫描您的代码并生成要替换的 API 的报告。

跳至：

• 扫描现有 MobileFirst 本机 Windows 应用程序以准备版本升级
• 迁移 Windows 项目
• 更新 Windows 代码

扫描现有 MobileFirst 本机 Windows 应用程序以准备版本升级

迁移辅助工具可帮助您准备通过 IBM MobileFirst™ Platform Foundation 先前版本创建的应用程序以执行迁移，方法是扫描本机 Windows 应用程序的源文件并生成 V8.0 中不推荐使用或停用的 API 的报告。

使用迁移辅助工具之前，务必了解以下信息：

• 您必须具有现有 IBM MobileFirst Platform Foundation 本机 Windows 应用程序。
• 您必须具有因特网访问权。
• 您必须已安装 node.js V4.0.0 或更高版本。
• 查看并了解迁移过程的限制。 有关更多信息，请参阅从先前发行版迁移应用程序。

对于使用 IBM MobileFirst Platform Foundation 的先前版本创建的应用程序，在未进行一些更改的情况下在 V8.0 中不受支持。 迁移辅助工具通过扫描现有本机 Windows 应用程序中的源文件，识别 V8.0 中不推荐使用、不再支持或修改的 API，从而简化此过程。

迁移辅助工具不会修改或移动应用程序的任何开发人员代码或注释。

1. 通过使用以下其中一种方法下载迁移辅助工具：
   • 从 Git 存储库下载 .tgz 文件。
   • 从 MobileFirst Operations Console 下载MobileFirst Developer Kit，其中包含名为 mfpmigrate-cli.tgz 的迁移辅助工具文件。
2. 安装迁移辅助工具。
   • 切换到下载工具的目录。
   • 通过输入以下命令，使用 NPM 安装该工具：

   npm install -g
   

3. 通过输入以下命令来扫描 IBM MobileFirst Platform Foundation 应用程序：

   mfpmigrate scan --in source_directory --out destination_directory --type windows
   

   source_directory
   项目的当前位置。

   destination_directory
   创建报告的目录。

   与 scan 命令一起使用时，迁移辅助工具会识别现有 IBM MobileFirst Platform Foundation 应用程序中在 V8.0 中已除去、不推荐使用或更改的 API，并将它们保存在确定的目标目录中。

迁移 Windows 项目

要使用通过 IBM MobileFirst™ Platform Foundation V6.2.0 或更高版本创建的现有本机 Windows 项目，必须修改该项目。

MobileFirst V8.0 仅支持 Windows Universal 环境，即 Windows 10 Universal Windows Platform (UWP) 和 Windows 8 Universal（台式机和手机）。 不支持 Windows Phone 8 Silverlight。

您可以手动将 Visual Studio 项目升级到 V8.0。 MobileFirst V8.0 针对 Visual Studio SDK 引入的一些更改可能需要更改在先前版本中开发的应用程序。 有关已更改的 API 的信息，请参阅更新 Windows 代码。

1. 将 MobileFirst SDK 更新至 V8.0。
   • 手动除去 MobileFirst SDK 包。 这包括除去 wlclient.properties 文件以及下列引用：
     • Newtonsoft.Json
     • SharpCompress
     • worklight-windows8

     注：如果您的应用程序使用应用程序真实性或扩展真实性功能，那么必须添加 Microsoft Visual C++ 2013 Runtime Package for Windows 或 Microsoft Visual C++ 2013 Runtime Package for Windows Phone 作为对应用程序的引用。要执行此操作，请在 Visual Studio 中，右键单击本机项目的引用，然后根据已将哪个环境添加到本机 API 应用程序来完成以下选项之一：

     • 对于 Windows 台式机和平板电脑：右键单击引用 → 添加引用 → Windows 8.1 → 扩展 → Microsoft Visual C++ 2013 Runtime Package for Windows → 确定。
     • 对于 Windows Phone 8 Universal：右键单击引用 → 添加引用 → Windows 8.1 → 扩展 → Microsoft Visual C++ 2013 Runtime Package for Windows Phone → 确定。
     • 对于 Windows 10 Universal Windows Platform (UWP)：右键单击引用 → 添加引用 → Windows 8.1 → 扩展 → Microsoft Visual C++ 2013 Runtime Package for Windows Universal → 确定。
   • 通过 NuGet 添加 MobileFirst V8.0.0 SDK 包。 请参阅使用 NuGet 添加 MobileFirst SDK。
2. 将应用程序代码更新为使用 MobileFirst V8.0.0 API。
   • 对于先前发行版，Windows API 是 IBM.Worklight.namespace 的一部分。 这些 API 现已过时并替换为等效的 WorklightNamespace API。 您需要修改应用程序，以将对 IBM.Worklight.namespace 的所有引用替换为 WorklightNamespace 中的对应等效项。

   例如，以下片段是使用示例：

   WLResourceRequest request = new WLResourceRequest
                            (new Uri(uriBuilder.ToString()), "GET", "accessRestricted");
                            request.send(listener);
   

   使用新 API 更新的片段将是：

   WorklightResourceRequest request = newClient.ResourceRequest
                            (new Uri(uriBuilder.ToString(), UriKind.Relative), "GET", "accessRestricted");
                            WorklightResponse response = await request.Send();
   

   • 所有执行异步操作的方法先前都使用响应侦听器回调模型。 这些方法已替换为 await/async 模型。

现在，您可以开始使用 MobileFirst SDK 来开发本机 Windows 应用程序。 您可能需要更新代码来反映 MobileFirst V8.0.0 API 更改。

后续步骤

替换 V8.0 中停用或不包含的客户端 API。

更新 Windows 代码

Mobile Foundation V8.0 针对 Windows SDK 引入的一些更改可能需要更改在先前版本中开发的应用程序。

不推荐使用的 Windows C# API 类

不推荐使用的 Windows C# API 接口