共用方式為

.NET Native 使用者入門

  • 發行項

無論您是撰寫新的 UWP 應用程式，還是移轉現有的 Windows 8.x 應用程式 (先前也稱為 Microsoft Store 應用程式)，您都可以遵循相同的程式集。 若要建立 .NET Native 應用程式，請遵循下列步驟：

  1. 開發通用 Windows 平台 (UWP) 應用程式，並測試應用程式的偵錯組建，以確保運作正常。

  2. 處理其他反映和序列化使用。

  3. 部署並測試應用程式的發行組建。

  4. 手動解決遺漏中繼資料的問題，然後重複 步驟 3 直到所有問題解決為止。

注意

如果您要將現有的 Windows 8.x 應用程式移轉至 .NET Native，請務必檢閱將 Windows 8.x 應用程式移轉至 .NET Native。

步驟 1：開發並測試 UWP 應用程式的偵錯組建

不論您要開發新的應用程式，或移轉現有的應用程式，都會遵循與所有 Windows 應用程式相同的程序。

  1. 使用適用於 Visual C# 或 Visual Basic 的通用 Windows 應用程式範本，在 Visual Studio 中建立新的 UWP 專案。 根據預設，所有 UWP 應用程式都會以 CoreCLR 為目標，而其發行組建則使用 .NET Native 工具鏈進行編譯。

  2. 請注意，使用 .NET Native 工具鏈編譯 UWP 應用程式專案與不使用此工具進行編譯之間有一些已知的相容性問題。 如需詳細資訊，請參閱 移轉指南 。

您現在可以針對在本機系統上 (或模擬器中) 執行的 .NET Native 介面區，撰寫 C# 或 Visual Basic 程式碼。

重要

當您開發應用程式時，請記下在程式碼中使用的任何序列化或反映。

根據預設，偵錯組建為 JIT 編譯，以便快速部署 F5，而發行組建會使用 .NET Native 先行編譯技術來編譯。 這表示您應該建置並測試應用程式的偵錯組建以確保運作正常，再使用 .NET Native 工具鏈進行編譯。

步驟 2：處理其他的反映和序列化使用

當您建立專案時會自動將執行階段指示詞檔 Default.rd.xml 加入您的專案。 如果您以 C# 進行開發，它位於您專案的 [屬性] 資料夾。 如果您以 Visual Basic 進行開發，它位於您專案的 [我的專案] 資料夾。

注意

如需 .NET 原生編譯程序的概觀 (其提供需要執行階段指示詞檔案的背景資訊)，請參閱 .NET 原生和編譯。

執行階段指示詞檔案會用來定義您的應用程式在執行階段所需的中繼資料。 在某些情況下，檔案的預設版本應已足夠。 不過，某些相依於序列化或反映的程式碼可能需要執行階段指示詞檔案中的其他項目。

序列化

序列化程式可分為兩種類別，這兩種類別都需要執行階段指示詞檔案中的其他項目：

  • 非反映型序列化程式。 .NET Framework 類別庫中不依賴反映的序列化程式，例如 DataContractSerializer、 DataContractJsonSerializer和 XmlSerializer 類別。 不過，這些序列化程式需要依據所要序列化或還原序列化的物件來產生程式碼。 如需詳細資訊，請參閱 Serialization and Metadata中的＜Microsoft 序列化程式＞一節。

  • 協力廠商序列化程式。 協力廠商序列化程式庫 (最常見的程式庫是 Newtonsoft JSON 序列化程式) 通常是反映型，並且需要 *.rd.xml 檔中的項目才能支援物件序列化和還原序列化。 如需詳細資訊，請參閱 Serialization and Metadata中的＜協力廠商序列化程式＞一節。

依賴反映的方法

在某些情況下，很難察覺程式碼中是否有使用反映。 某些常見的 API 或程式設計模式不是反映 API 的一部分，但依賴反映才能順利執行。 其中包括下列類型具現化和方法建構方法：

如需詳細資訊，請參閱 APIs That Rely on Reflection。

注意

執行階段指示詞檔案中使用的類型名稱必須是完整名稱。 例如，檔案必須指定 "System.String"，而不是 "String"。

步驟 3：部署並測試應用程式的發行組建

更新執行階段指示詞檔案之後，您可以重建並部署應用程式的發行組建。 .NET Native 的二進位檔案位於專案屬性對話方塊的編譯索引標籤中的建置輸出路徑文字方塊中指定目錄的 ILC.out 子目錄中。未位於此資料夾中的二進位檔案尚未使用 .NET Native 編譯。 請在其目標平台上完整測試您的應用程式，並測試所有情況，包括失敗情況。

如果您的應用程式無法正常運作 (特別是如果在執行階段擲回 MissingMetadataException 或 MissingInteropDataException 例外狀況)，請遵循下一節步驟 4：手動解決遺漏中繼資料的問題中的指示進行。 啟用第一個可能發生的例外狀況可協助您尋找這些錯誤。

當您對應用程式的偵錯組建完成測試及偵錯，並確信已去除 MissingMetadataException 和 MissingInteropDataException 例外狀況時，您應該將應用程式當做 .NET Native 最佳化應用程式進行測試。 若要執行這項操作，請將使用中的專案組態從 [偵錯] 變更為 [發行] 。

步驟 4：手動解決遺漏中繼資料的問題

使用 .NET Native 會遇到但不會在桌面上遇到的最常見失敗，包括執行階段 MissingMetadataException、 MissingInteropDataException 或 MissingRuntimeArtifactException 例外狀況。 在某些情況下，缺少中繼資料會發生未預期的行為，甚至導致應用程式失敗。 本節討論如何將指示詞加入至執行階段指示詞檔案，來偵錯及解決這些例外狀況。 如需執行階段指示詞格式的資訊，請參閱執行階段指示詞 (rd.xml) 組態檔參考。 加入執行階段指示詞之後，您應該重新 部署及測試應用程式 ，並解決任何新的 MissingMetadataException、 MissingInteropDataException和 MissingRuntimeArtifactException 例外狀況，直到未遇到其他任何例外狀況為止。

提示

在較高層級指定執行階段指示詞，可讓應用程式彈性地回應程式碼變更。 建議在命名空間和類型層級加入執行階段指示詞，而不是在成員層級加入執行階段指示詞。 請注意，您可能需要在彈性與較大二進位檔案需要更長編譯時間之間進行取捨。

解決遺漏中繼資料的例外狀況時，請考慮下列問題：

  • 發生例外狀況之前，應用程式正嘗試執行哪項作業？

    • 例如，應用程式正在執行資料繫結、序列化或還原序列化資料，還是直接使用反映 API？

  • 這是獨立案例，還是您認為其他類型也會遇到相同問題？

    • 例如，當序列化應用程式物件模型中的類型時，擲回 MissingMetadataException 例外狀況。 如果您知道即將序列化其他類型，您可以同時針對這些類型 (視程式碼組織程度而定也可能針對其包含命名空間) 加入執行階段指示詞。

  • 是否可以重寫程式碼使其不使用反映？

    • 例如，當您知道預期類型時，程式碼是否使用 dynamic 關鍵字？

    • 程式碼是否在有一些更佳的替代方案時，呼叫相依於反映的方法？

注意

如需處理源自於桌面應用程式和 .NET Native 之間反映和中繼資料可用性差異之問題的其他資訊，請參閱依賴反映的 API。

如需處理測試應用程式時所發生之例外狀況和其他問題的一些特定範例，請參閱：

另請參閱