Practical Kotlin Multiplatform on the Web
본 저장소는 코틀린 멀티플랫폼 기반 웹 프로그래밍 워크숍(강좌)을 위해 작성된 템플릿 프로젝트가 있는 곳입니다.
워크숍 과정에서 코틀린 멀티플랫폼을 기반으로 프론트엔드(front-end)는 Kotlin/JS와 리액트(React), 백엔드(back-end)는 Kotlin/JVM과 스프링(Spring)을 사용해 풀스택 웹 애플리케이션이 만듭니다.
코틀린 멀티플랫폼
코틀린은 멀티플랫폼을 지원하는 언어로 JVM 기반 Server-side 및 Android 뿐만이 아니라 JavaScript 엔진이 있는 브라우저나 Node.js, 그리고 iOS, Linux, Windows 등 여러가지 Native 플랫폼에서도 쓸 수 있습니다. 이를 이용해 코틀린 코드를 공유하는 단일 코드베이스로 모바일부터 웹과 데스크톱, 서버에 이르기까지 멀티플랫폼 애플리케이션을 작성할 수 있습니다.
코틀린 멀티플랫폼 프로젝트는 아직 알파 버전이지만 실용적인 가능성에 기대어 기업에서 여러가지 시도를 하고 있습니다. 넷플릭스에서는 TV프로그램과 영화의 제작을 혁신적으로 제공하기 위해 Prodicle 앱을 개발하면서 코틀린으로 작성한 비즈니스 로직을 Kotlin/Native를 통해 Android용 Kotlin 라이브러리와 iOS용 기본 유니버설 프레임워크로 컴파일함해서 사용하고 있으며, 필립스는 자사의 제품들이 클라우드를 기반으로 통합되어 제품간의 검색, 연결 및 상호 작용을 위해 Android 및 iOS, 그리고 임베디드 Linux를 지원하는 SDK를 개발하며 코틀린 멀티플랫폼을 사용했습니다.
프로젝트 구성
├── gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle.kts
├── build.gradle.kts # Gradle build script
└── src
├── commonMain # Common Kotlin, application code
│ ├── kotlin
│ │ └── todoapp
│ │ ├── application # use-case module
│ │ ├── domain # domain module
│ │ ├── support
│ │ └── web # web adapter module
│ └── resources
├── commonTest # Common Kotlin, test code
│ ├── kotlin
│ │ ├── test
│ │ └── todoapp
│ └── resources
├── jsMain # Kotlin/JS, application code
│ ├── kotlin
│ │ └── todoapp
│ │ ├── application # use-case module
│ │ ├── ui # react-app module
│ │ └── TodoClientApplication.kt # client entry-point
│ └── resources
├── jsTest # Kotlin/JS, test code
│ ├── kotlin
│ │ ├── test
│ │ └── todoapp
│ └── resources
├── jvmMain # Kotlin/JVM, application code
│ ├── kotlin
│ │ └── todoapp
│ │ ├── application # use-case module
│ │ ├── data # data adapter module
│ │ ├── web # web adapter module
│ │ └── TodoServerApplication.kt # server entry-point
│ └── resources
│ ├── static # static resources (images)
│ ├── application.yml # spring-boot externalized configuration
│ ├── schema.sql # database schema create script
│ └── data.sql # database data init script
└── jvmTest # Kotlin/JVM, test code
├── kotlin
│ ├── test
│ └── todoapp
└── resources
개발 환경
- Kotlin 1.6.x (with Java 11)
- Share common-code
- Front-end
- Back-end
- Kotlin/JVM
- Spring WebFlux 5.2.x
- Spring Data R2DBC 1.4.x
- Spring Boot 2.6.x
- Kotest 5.0.x (with JUnit 5)
- Tools: Gradle 7.2, IntelliJ IDEA 2022.2 (Community Edition)
빌드 및 실행
저장소 코드를 내려받은 후 터미널에서 다음 명령어를 입력하고, 애플리케이션이 실행되면 브라우저에서 http://localhost:8080/?mode=remote 로 접속합니다.
❯ ./gradlew clean bootRun
> Configure project :
Kotlin Multiplatform Projects are an Alpha feature. See: https://kotlinlang.org/docs/reference/evolution/components-stability.html. To hide this message, add 'kotlin.mpp.stability.nowarn=true' to the Gradle properties.
> Task :bootRun
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.6.8)
...
todoapp.TodoServerApplicationKt : Started TodoServerApplicationKt in 1.349 seconds (JVM running for 1.504)
o.s.b.f.s.DefaultListableBeanFactory : Returning cached instance of singleton bean 'applicationAvailability'
o.s.b.a.ApplicationAvailabilityBean : Application availability state LivenessState changed to CORRECT
o.s.b.f.s.DefaultListableBeanFactory : Returning cached instance of singleton bean 'applicationAvailability'
o.s.b.a.ApplicationAvailabilityBean : Application availability state ReadinessState changed to ACCEPTING_TRAFFIC
<============-> 96% EXECUTING [34s]
> :bootRun
517 Nov 19, 2022
15 Oct 3, 2022
5 Feb 15, 2022
43 Aug 17, 2022
13 Aug 4, 2022
34 Dec 30, 2022
26 Jan 3, 2023
362 Dec 29, 2022
1 Dec 17, 2021
2 May 29, 2022
12 Dec 16, 2022
69 Nov 9, 2022
41 Dec 21, 2022
50 Nov 20, 2022
32 Jan 4, 2023
3 Nov 5, 2022
2 Aug 4, 2022
372 Dec 28, 2022
39 Nov 4, 2022