# JavaScript DCE [TOC] 自版本 1.1.4 起，Kotlin/JS 包含了一個無用代碼消除（DCE，dead code elimination）工具。 該工具允許在生成的 JS 中刪除未使用的屬性、函數和類。 出現未使用的聲明有這幾種可能情況： * 函數可以內聯并且從未直接調用（除少數情況之外，這總會出現）。 * 你所使用的共享庫提供了比實際需要更多的功能/函數。 例如，標準庫（`kotlin.js`）包含用于操作列表、數組、字符序列、 DOM 適配器等的函數/功能，這些一起提供了大約 1.3 mb 的文件。一個簡單的“Hello, world”應用程序只需要控制臺程序，整個文件只有幾千字節。 無用代碼消除通常也稱為“tree shaking”。 ## 如何使用 DCE 工具目前對 Gradle 可用。 要激活 DCE 工具，請將以下這行添加到 `build.gradle` 中： ``` groovy apply plugin: 'kotlin-dce-js' ``` 請注意，如果你正在使用多項目構建，那么應該將插件應用在作為應用程序入口點的主項目。 默認情況下，可以在路徑 `$BUILD_DIR/min/` 中找到生成的一組 JavaScript文件（你的應用程序與所有依賴關系），其中 `$BUILD_DIR` 是生成 JavaScript 的路徑（通常是 `build/classes/main`）。 ### 配置 要在主源集上配置 DCE，可以使用 `runDceKotlinJs` 任務（以及用于其他源集對應的`runDce<sourceSetName>KotlinJs`）。 有時你直接在 JavaScript 中使用一個 Kotlin 聲明，而被 DCE 給去除掉了。你可能想保留這個聲明。 為此，你可以在 `build.gradle` 中使用以下語法： ``` groovy runDceKotlinJs.keep "declarationToKeep"[, "declarationToKeep", ...] ``` 其中 `declarationToKeep` 具有以下語法： ``` moduleName.dot.separated.package.name.declarationName ``` 例如，考慮一個模塊命名為 `kotlin-js-example`，它在 `org.jetbrains.kotlin.examples` 包中包含一個名為 `toKeep` 的函數。使用以下這行： ``` groovy runDceKotlinJs.keep "kotlin-js-example_main.org.jetbrains.kotlin.examples.toKeep" ``` 請注意，如果函數具有參數，它的名稱會被修飾，因此在 keep 指令中應該使用修飾后的名稱。 ### 開發模式 運行 DCE 在每次構建時會額外花費一些時間，而且輸出大小在開發過程中無關緊要。可以通過 DCE 任務的 `dceOptions.devMode` 標志使 DCE 工具跳過實際的無效代碼消除從而縮短開發構建時間。 例如，如需根據自定義條件禁用 `main` 源集的 DCE 并且總是禁用 `test` 代碼的 DCE，請將下述幾行添加到構建腳本中： ```groovy runDceKotlinJs.dceOptions.devMode = isDevMode runDceTestKotlinJs.dceOptions.devMode = true ``` # 示例 顯示如何將 Kotlin 與 DCE 及 webpack 集成并得到一個小的捆綁的完整示例， 可以在[這里](https://github.com/JetBrains/kotlin-examples/tree/master/gradle/js-dce)找到。 ## 注意事項 * 對于 1.1.x 版本，DCE 工具是一個 *實驗性的* 特性。這并不意味著我們要刪除它，或者它不能用于生產。這意味著我們可能更改配置參數的名稱、默認設置等等。 * 目前，如果你的項目是共享庫，那么不應使用 DCE 工具。它只適用于開發應用程序（可能使用共享庫）時。原因是：DCE 不知道庫的哪些部分會被用戶的應用程序所使用。 * DCE 不會通過刪除不必要的空格及縮短標識符來執行代碼壓縮（丑化）。對于此目的，你應該使用現有的工具，如 UglifyJS（https://github.com/mishoo/UglifyJS2 ）或者 Google Closure Compiler（https://developers.google.com/closure/compiler/ ）。