# Kotlin/Native 庫 [TOC] ## Kotlin 編譯器細節 用 Kotlin/Native 編譯器生成一個庫，請使用 `-produce library` 或者 `-p library` 標志。例如： ```bash $ kotlinc foo.kt -p library -o bar ``` 上述命令會生成一個帶有 `foo.kt` 編譯后的內容的庫 `bar.klib`。 鏈接到一個庫請使用 `-library ﹤庫名﹥` or `-l ﹤庫名﹥` 標志。例如： ```bash $ kotlinc qux.kt -l bar ``` 上述命令會由 `qux.kt` 與 `bar.klib` 生成 `program.kexe` ## cinterop 工具細節 **cinterop** 工具為原生庫生成 `.klib` 包裝作為其主要輸出。例如，使用 Kotlin/Native 發行版中提供的簡單 `libgit2.def` 原生庫定義文件 ```bash $ cinterop -def samples/gitchurn/src/nativeInterop/cinterop/libgit2.def -compiler-option -I/usr/local/include -o libgit2 ``` 會得到 `libgit2.klib`。 更多詳情請參見 [INTEROP.md](http://www.kotlincn.net/docs/reference/native/c_interop.html) ## klib 實用程序 **klib** 庫管理實用程序可以探查與安裝庫。 可以使用以下命令。 列出庫的內容： ```bash $ klib contents ﹤庫名﹥ ``` 探查庫的簿記細節 ```bash $ klib info ﹤庫名﹥ ``` 將庫安裝到默認位置，使用 ```bash $ klib install ﹤庫名﹥ ``` 將庫從默認存儲庫中刪除，使用 ```bash $ klib remove ﹤庫名﹥ ``` 上述所有命令都接受一個額外的 `-repository ﹤目錄﹥` 參數，用于指定與默認不同的存儲庫。 ```bash $ klib ﹤命令﹥ ﹤庫名﹥ -repository ﹤目錄﹥ ``` ## 幾個示例 首先創建一個庫。將微型庫的源代碼寫到 `kotlinizer.kt` 中： ```kotlin package kotlinizer val String.kotlinized get() = "Kotlin $this" ``` ```bash $ kotlinc kotlinizer.kt -p library -o kotlinizer ``` 該庫已在當前目錄中創建： ```bash $ ls kotlinizer.klib kotlinizer.klib ``` 現在來看看庫的內容： ```bash $ klib contents kotlinizer ``` 可以將 `kotlinizer` 安裝到默認存儲庫： ```bash $ klib install kotlinizer ``` 從當前目錄中刪除它的任何痕跡： ```bash $ rm kotlinizer.klib ``` 創建一個非常短的程序并寫到 `use.kt` 中： ```kotlin import kotlinizer.* fun main(args: Array<String>) { println("Hello, ${"world".kotlinized}!") } ``` 現在編譯該程序鏈接到剛剛創建的庫： ```bash $ kotlinc use.kt -l kotlinizer -o kohello ``` 并運行該程序： ```bash $ ./kohello.kexe Hello, Kotlin world! ``` 樂在其中！ # 高級主題 ## 庫搜索順序 當給出 `-library foo` 標志時，編譯器按照以下順序搜索 `foo` 庫： * 當前編譯目錄或者一個絕對路徑。 * 以 `-repo` 標志指定的所有存儲褲。 * 安裝在默認存儲庫（目前默認為 `~/.konan`，不過可以通過設置 **KONAN_DATA_DIR** 來更改）中的庫。 * 安裝在 `$installation/klib` 目錄中的庫。 ## 庫格式 Kotlin/Native 是包含預定義目錄結構的 zip 文件， 具有以下布局： **foo.klib** 當解壓為 **foo/** 時會有： ```yaml - foo/ - targets/ - $platform/ - kotlin/ - Kotlin 編譯為 LLVM 位碼（bitcode）。 - native/ - 附加原生對象的位碼文件。 - $another_platform/ - 可以有幾個平臺相關的 kotlin 與原生對。 - linkdata/ - 一組帶有序列化的鏈接元數據的 ProtoBuf 文件。 - resources/ - 圖像等普通資源。(尚未使用)。 - manifest——描述庫的 *java 屬性*格式文件。 ``` 可以在安裝的 `klib/stdlib` 目錄中找到示例布局。