Skip to content
Server Plugin

Webjars

필수 의존성: io.ktor:ktor-server-webjars

코드 예시: webjars

네이티브 서버
Ktor는 Kotlin/Native를 지원하며 추가 런타임이나 가상 머신 없이 서버를 실행할 수 있게 해줍니다.
지원: ✖️

Webjars 플러그인은 WebJars가 제공하는 클라이언트 측 라이브러리를 서빙할 수 있도록 합니다. 이를 통해 JavaScript 및 CSS 라이브러리와 같은 애셋을 fat JAR의 일부로 패키징할 수 있습니다.

의존성 추가

Webjars을(를) 활성화하려면 빌드 스크립트에 다음 아티팩트를 포함해야 합니다.

  • ktor-server-webjars 의존성을 추가합니다:

    Kotlin
    Groovy
    XML
  • 필수 클라이언트 측 라이브러리에 대한 의존성을 추가합니다. 아래 예시는 Bootstrap 아티팩트를 추가하는 방법을 보여줍니다:

    Kotlin
    Groovy
    XML

    $bootstrap_versionbootstrap 아티팩트의 필수 버전(예: 5.2.3)으로 바꿀 수 있습니다.

Webjars 설치

애플리케이션에 Webjars 플러그인을 설치하려면, 지정된

모듈
모듈을 사용하면 경로를 그룹화하여 애플리케이션을 구조화할 수 있습니다.
install 함수에 전달하십시오. 아래 코드 스니펫은 Webjars을(를) 설치하는 방법을 보여줍니다...

  • ... embeddedServer 함수 호출 내에서.
  • ... Application 클래스의 확장 함수인 명시적으로 정의된 module 내에서.
kotlin
kotlin

Webjars 구성

기본적으로 Webjars은(는) /webjars 경로에 WebJars 애셋을 서빙합니다. 아래 예시는 이를 변경하여 모든 WebJars 애셋을 /assets 경로에 서빙하는 방법을 보여줍니다:

kotlin
import io.ktor.server.application.*
import io.ktor.server.webjars.*

fun Application.module() {
    install(Webjars) {
        path = "assets"
    }
}

예를 들어, org.webjars:bootstrap 의존성을 설치했다면, 다음과 같이 bootstrap.css를 추가할 수 있습니다:

html
<head>
    <link rel="stylesheet" href="/assets/bootstrap/bootstrap.css">
</head>

Webjars을(를) 사용하면 의존성 로드에 사용되는 경로를 변경하지 않고도 의존성 버전을 변경할 수 있습니다.

전체 예시는 여기에서 찾을 수 있습니다: webjars.