Share via


系結 Android Kotlin 連結庫

重要

我們目前正在調查 Xamarin 平臺上的自定義系結使用方式。 請接受 這項調查 ,以通知未來的開發工作。

Android 平臺及其原生語言和工具不斷演進,而且有許多使用最新供應項目開發的第三方連結庫。 最大化程式代碼和元件重複使用是跨平台開發的主要目標之一。 重複使用使用 Kotlin 建置的元件的能力,對於 Xamarin 開發人員來說,隨著開發人員的受歡迎程度持續成長,對 Xamarin 開發人員來說越來越重要。 您可能已經熟悉系結一般 Java 連結 庫的程式。 現在已提供其他檔來描述系結 Kotlin 連結庫的程式,因此 Xamarin 應用程式會以相同方式取用它們。 本檔的目的是描述建立 Xamarin Kotlin 系結的高階方法。

高階方法

您可以使用 Xamarin 系結任何第三方原生連結庫,讓 Xamarin 應用程式取用。 Kotlin 是新的語言,並且針對使用此語言建置的連結庫建立系結需要一些額外的步驟和工具。 此方法牽涉到下列四個步驟:

  1. 建置原生連結庫
  2. 準備 Xamarin 元數據,讓 Xamarin 工具產生 C# 類別
  3. 使用原生連結庫和元數據建置 Xamarin 系結連結庫
  4. 在 Xamarin 應用程式中取用 Xamarin 系結連結庫

下列各節將概述這些步驟,其中包含其他詳細數據。

建置原生連結庫

第一個步驟是取得原生 Kotlin 連結庫(AAR 套件,也就是 Android 封存)。 您可以直接從廠商要求它,或自行建置。

準備 Xamarin 元數據

第二個步驟是準備元數據轉換檔案,此檔案將由 Xamarin 工具用來產生個別的 C# 類別。 在最佳案例中,此檔案可能是空的,其中 Xamarin 工具會探索併產生所有類別。 在某些情況下,必須套用元數據轉換來產生正確的和/或所需的 C# 程序代碼。 在許多情況下,AAR 反彙編程式,例如 Java Decompiler (JD),必須用來識別您想要從要產生之 C# 類別的最終清單中排除的隱藏相依性和垃圾類別。 最後的元數據應該代表參考 Xamarin.Android 應用程式會與其互動的公用介面。

建置 Xamarin.Android 系結連結庫

第三個步驟是建立特殊專案 - Xamarin.Android 系結連結庫。 它包含 Kotlin 連結庫作為原生參考,以及上一個步驟中定義的元數據轉換。 撰寫時,每個要參考的 AAR 套件都需要個別的 Android 系結連結庫專案。 系結連結庫必須新增 Xamarin.Kotlin.StdLib 套件,才能支援 Kotlin 標準連結庫。

取用 Xamarin 系結連結庫

第四個步驟和第一個步驟是參考 Xamarin.Android 應用程式中的系結連結庫。 新增 Xamarin.Android 系結連結庫的參考,可讓您的 Xamarin 應用程式使用該套件內公開的 Kotlin 類別。

逐步解說

上述方法概述為 Xamarin 建立 Kotlin 系結所需的高階步驟。 在實務上準備這些系結時,涉及許多較低層級的步驟和進一步的詳細數據,包括適應原生工具和語言的變更。 其目的是要協助您更深入地瞭解此概念,以及此程式所涉及的高階步驟。 如需詳細的逐步指南,請參閱 Xamarin Kotlin 系結 逐步解說檔。