Share via

移植到通用 Windows 平台 (C++)

  • 發行項

在本主題中，您可以找到如何將現有 C++ 程式碼移植到 Windows 應用程式平臺的資訊，通用 Windows 平臺。 通用 一詞 的意義在於，您的程式碼可以在任何執行 Windows 10 或更新版本的裝置上執行。 您可以建立單一專案和單一 XAML 基底使用者介面，可在任何執行 Windows 10 或更新版本的裝置上運作良好。 您可以在 XAML 中使用動態配置功能，以允許應用程式的 UI 適應不同的顯示器大小。

Windows 開發人員中心文件包含如何將 Windows 8.1 應用程式移植到通用 Windows 平台的指南。 請參閱 從 Windows 執行階段 8 移至 UWP。 雖然本指南大部分著重於 C# 程式碼，但大部分的指引也適用於 C++。 下列程序包含更詳細的資訊。 另 請參閱從傳統型應用程式移至 UWP 。

本主題包含將程式碼移植到 UWP 的程序，如下所示。

若您有傳統桌面的 Win32 DLL，並想要從 UWP 應用程式加以呼叫，您也可以執行此作業。 使用這類程序可以為現有的傳統 Windows 桌面的 C++ 應用程式或跨平台標準 C++ 程式碼建立 UWP 使用者介面層。 請參閱做法：在通用 Windows 平台應用程式中使用現有的 C++ 程式碼。

將 Windows 8.1 市集應用程式移植到 UWP

如果您有 Windows 8.1 市集應用程式，您可以使用此程式在 UWP 和任何執行 Windows 10 或更新版本的裝置上運作。 最好先使用 Visual Studio 2019 做為 Windows 8.1 專案來建置專案，先排除編譯器和程式庫變更所產生的任何問題。 完成後，有兩種方式可將它轉換成 Windows UWP 專案。 最簡單的方式 (如下列程序所述) 就是建立通用 Windows 專案，然後將現有的程式碼複製到其中。 若您是使用 Windows 8.1 桌面及 Windows 8.1 Phone 的通用專案，則您的專案將會從兩個不同的配置的 XAML 開始，但最後則會演變成可以調整成顯示器大小的單一動態配置。

將 Windows 8.1 市集應用程式移植到 UWP

  1. 若還未如此做，請在 Visual Studio 2017 中開啟 Windows 8.1 應用程式專案，並依照指示升級專案檔。

    您必須已在 Visual Studio 安裝程式中安裝 Windows 8.1 工具。 若還未安裝這些工具，請從 [程式和功能] 視窗中啟動 Visual Studio 安裝程式，選擇 [Visual Studio 2017]，然後在安裝程式視窗中選擇 [修改]。 找出 [Windows 8.1 工具]，確認已加以選取，然後選擇 [確定]。

  2. 開啟 [專案屬性] 視窗，然後在 [C++]>[一般] 中，將 [平台工具組] 設定為 v141，即 Visual Studio 2017 的工具組。

  3. 將專案建置為 Windows 8.1 專案，並解決任何建置錯誤。 在這個階段的任何錯誤都有可能是出於建置工具和程式庫的重大變更。 如需可能會影響程式碼之變更的詳細說明，請參閱 Visual C++ 變更歷程記錄 2003 - 2015。

    一旦專案完全建置之後，您就可以移植到通用 Windows 平臺。

  4. 使用空白範本建立新的通用 Windows 應用程式專案。 您也許想提供給它與現有專案相同的名稱，但若要這麼做，則此專案必須是在不同的目錄中。

  5. 請關閉解決方案，然後使用 Windows 檔案總管或命令列，將程式碼檔案 (副檔名為 .cpp、.h 和 .xaml) 從 Windows 8.1 專案複製到與您在步驟 1 中所建立專案之專案檔 (.vcxproj) 相同的資料夾內。 請勿複製 Package.appxmanifest 檔案，而如果您有針對 Windows 8.1 桌面版和 Phone 的不同程式碼，請選擇其中一個先進行移植 (您稍後必須先執行一些工作，以套用到其他工作)。 請務必複製子資料夾和其內容。 如果出現提示，請選擇取代任何重複名稱的檔案。

  6. 重新開啟解決方案，然後選擇專案節點捷徑功能表中的 [新增]>[現有項目]。 請選取您已複製的所有檔案，但是已為專案之一部分的任何檔案除外。

    請檢查任何子資料夾，並請確認在其中新增這些檔案。

  7. 如果您不使用和舊專案相同的專案名稱，則請開啟 Package.appxmanifest 檔案，更新 [進入點] 以反映 App 類別的命名空間名稱。

    Package.appxmanifest 檔案中的 [進入點] 欄位包含 App 類別的範圍名稱，其中包括包含 App 類別的命名空間。 當您建立通用 Windows 專案時，此命名空間會設為專案的名稱。 如果這和從舊的專案中複製的檔案不同，則您必須更新其中之一或其他檔案，使兩者相符。

  8. 建置專案，並解決任何出於 Windows SDK 不同版本之間之重大變更的建置錯誤。

  9. 在本機桌面上執行專案。 請確認沒有部署錯誤，也請確認應用程式的版面配置看起來是否合理，以及是否可在桌面上正確運作。

  10. 如果您有針對另一個裝置的不同程式碼檔案和 .xaml，例如 Windows Phone 8.1，請檢查這段程式碼，並識別其中何處不同於標準裝置。 如果不同之處只在於版面配置，您也許可在 xaml 中使用 Visual State Manager，依螢幕大小自訂顯示。 至於其他差異，您可以在使用下列 #if 陳述式的程式碼中使用條件區段。

    #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PC_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PHONE_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

    這些陳述式分別適用於 UWP 應用程式、Windows Phone Store 應用程式、兩者都適用或兩者均不適用 (僅傳統 Win32 桌面)。 這些巨集只能在 Windows SDK 8.1 和更新版本中使用，因此如果您的程式碼需要使用舊版 Windows SDK 編譯或用於 Windows 以外的其他平台，那麼您也應該考慮無一定義的情況。

  11. 針對應用程式支援的每個裝置類型，請在模擬器或實體裝置上執行和偵錯應用程式。 若要執行模擬器，您需要在實體電腦上執行 Visual Studio，而不是虛擬機器。

將 Windows 8.1 執行階段元件移植到 UWP

如果您有已搭配 Windows 8.1 市集應用程式的 DLL 或Windows 執行階段元件，您可以使用此程式來取得在 Windows 上使用 UWP 的元件或 DLL。 基本程序為建立新的專案，並將您的程式碼複製到其中。

將 Windows 8.1 執行階段元件移植到 UWP

  1. 在 Visual Studio 2017 的 [新專案] 對話方塊中，找出 [Windows 通用] 節點。 如果您沒有看到此節點，請先安裝 Windows SDK 。 選擇 [Windows 執行階段元件] 範本，再為元件命名，然後選擇 [確定] 按鈕。 此元件名稱會用為命名空間的名稱，因此您可能會想要使用舊專案的命名空間名稱。 這需要您從舊專案將專案建立在與不同的資料夾中。 若選擇不同的名稱，可以在產生的程式碼檔案中，更新命名空間的名稱。

  2. 關閉專案。

  3. 從您的 Windows 8.1 元件，將所有程式碼檔案 (.cpp、.h、.xaml 等) 複製到新建立的專案。 請勿複製 Package.appxmanifest 檔案。

  4. 建置並解決任何起因於 Windows SDK 不同版本間之重大變更的錯誤。

疑難排解

在將程式碼移植到 UWP 的過程中，可能會遇到多種問題。 以下是一些可能會遇到的問題。

專案組態問題

您可能會收到下列錯誤：

could not find assembly 'platform.winmd': please specify the assembly search path using /AI or by setting the LIBPATH environment variable

如果發生這種情況，就不會將專案建置為 Windows 通用專案。 請檢查此專案檔，並確定它具有正確的 XML 項目，且它會將專案識別為 Windows 的通用專案。 下列項目應會出現 (目標平台的版本號碼可能會不同)：

<AppContainerApplication>true</AppContainerApplication>
<ApplicationType>Windows Store</ApplicationType>
<WindowsTargetPlatformVersion>10.0.10156.0</WindowsTargetPlatformVersion>
<WindowsTargetPlatformMinVersion>10.0.10156.0</WindowsTargetPlatformMinVersion>
<ApplicationTypeRevision>10.0</ApplicationTypeRevision>

若是使用 Visual Studio 建立新的 UWP 專案，應不會出現此錯誤。

另請參閱

Visual C++ 移植指南
開發適用於通用 Windows 平台 (UWP) 的應用程式