Генерация внешних деклараций с помощью Dukat

Генерация внешних деклараций во время сборки

Функция зависимости npm принимает третий параметр после имени и версии пакета: generateExternals. Это позволяет управлять тем, должны ли Dukat генерировать декларации для конкретной зависимости:

dependencies {
    implementation(npm("decamelize", "4.0.0", generateExternals = true))
}

dependencies {
    implementation(npm('decamelize', '4.0.0', true))
}

Если репозиторий зависимости, которую вы хотите использовать, не предоставляет определения TypeScript, вы также можете использовать типы, предоставленные через репозиторий DefinitelyTyped. В этом случае убедитесь, что вы добавили зависимости npm для your-package и @types/your-package (с generateExternals = true).

Вы можете использовать опцию kotlin.js.generate.externals в вашем файле gradle.properties, чтобы установить поведение генератора для всех npm-зависимостей одновременно. Как обычно, индивидуальные явные настройки имеют приоритет над этой общей опцией.

Вручную генерировать внешние декларации через задачу Gradle

Если вы хотите иметь полный контроль над декларациями, генерируемыми Dukat, хотите внести правки вручную или сталкиваетесь с проблемами при автоматической генерации внешних деклараций, вы также можете вручную инициировать создание деклараций для всех ваших npm-зависимостей с помощью задачи Gradle generateExternals (jsGenerateExternals с плагином multiplatform). Это сгенерирует декларации в каталоге externals в корне вашего проекта. Здесь вы можете просмотреть сгенерированный код и скопировать любые необходимые части в свои каталоги исходных кодов.

Рекомендуется обеспечивать внешние декларации вручную только в папке исходного кода или включать генерацию внешних деклараций во время сборки для каждой отдельной зависимости. Одновременное выполнение обоих действий может привести к проблемам с разрешением.