Kotlinスクリプトで効率的に複数プロジェクトを管理する方法を徹底解説

println("Hello, Kotlin Script!")

kotlinc -script example.kts

import java.io.File

val projectDirs = listOf("project1", "project2", "project3")

projectDirs.forEach { dir ->
    println("Building project in $dir...")
    val process = ProcessBuilder("gradle", "build")
        .directory(File(dir))
        .inheritIO()
        .start()
    process.waitFor()
    println("Build completed for $dir")
}

plugins {
    id 'org.jetbrains.kotlin.jvm' version '1.8.0'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.jetbrains.kotlin:kotlin-stdlib'
}

plugins {
    kotlin("jvm") version "1.8.0"
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.jetbrains.kotlin:kotlin-stdlib")
}

import java.io.File

val projects = listOf("project1", "project2", "project3")

projects.forEach { project ->
    println("Building $project...")
    val process = ProcessBuilder("gradle", "build")
        .directory(File(project))
        .inheritIO()
        .start()
    process.waitFor()
    println("Build completed for $project")
}

rootProject.name = "multi-project-example"
include("project1", "project2", "project3")

  tasks.register("cleanAll") {
      dependsOn(":project1:clean", ":project2:clean", ":project3:clean")
  }

  subprojects {
      repositories {
          mavenCentral()
      }
      dependencies {
          implementation("org.jetbrains.kotlin:kotlin-stdlib")
      }
  }

import java.io.File

val projectDirs = listOf("project1", "project2", "project3")

projectDirs.forEach { dir ->
    println("Building project in $dir...")
    val process = ProcessBuilder("gradle", "build")
        .directory(File(dir))
        .inheritIO()
        .start()
    process.waitFor()
    println("Build completed for $dir")
}

import java.io.File

val cacheDirs = listOf("project1/.gradle", "project2/.gradle", "project3/.gradle")

cacheDirs.forEach { cache ->
    val cacheDir = File(cache)
    if (cacheDir.exists()) {
        println("Deleting cache in $cache...")
        cacheDir.deleteRecursively()
    }
}

import java.io.File

val projects = listOf("project1", "project2", "project3")

projects.forEach { project ->
    println("Checking dependencies in $project...")
    val process = ProcessBuilder("gradle", "dependencies")
        .directory(File(project))
        .inheritIO()
        .start()
    process.waitFor()
}

import java.io.File

val projects = listOf("project1", "project2", "project3")
val updateText = "\n## Latest Update\n- Added new feature XYZ\n"

projects.forEach { project ->
    val readme = File("$project/README.md")
    if (readme.exists()) {
        readme.appendText(updateText)
        println("Updated README in $project")
    }
}

import java.io.File

fun runCommand(command: List<String>, dir: String) {
    val process = ProcessBuilder(command)
        .directory(File(dir))
        .inheritIO()
        .start()
    process.waitFor()
}

val projects = listOf("project1", "project2", "project3")

projects.forEach { project ->
    println("Running CI/CD tasks for $project...")
    runCommand(listOf("gradle", "clean", "build"), project)
    runCommand(listOf("gradle", "test"), project)
    println("CI/CD tasks completed for $project")
}

scripts/
│── build_all.kts         // 全プロジェクトをビルドするスクリプト
│── clean_caches.kts      // キャッシュ削除スクリプト
│── update_readme.kts     // READMEを更新するスクリプト
└── ci_cd_pipeline.kts    // CI/CDパイプライン用スクリプト

import java.io.File

fun runGradleTask(projectDir: String, task: String) {
    println("Running $task in $projectDir...")
    ProcessBuilder("gradle", task)
        .directory(File(projectDir))
        .inheritIO()
        .start()
        .waitFor()
}

try {
    runGradleTask("project1", "build")
} catch (e: Exception) {
    println("Error occurred: ${e.message}")
}

git commit -m "Add script to build all projects simultaneously"

## Scripts Guide

- **build_all.kts**: すべてのプロジェクトをビルドします。

- **clean_caches.kts**: ビルドキャッシュを削除します。

```

<h3>6. スクリプト実行環境を統一する</h3>  
全チームメンバーが同じJDKとKotlinのバージョンでスクリプトを実行できるように、バージョンを統一しましょう。

**バージョン指定例**：  

<h3>7. CI/CDパイプラインでの自動実行</h3>  
スクリプトをCI/CDパイプラインに組み込み、毎回手動で実行しなくてもタスクが自動で処理されるように設定します。

**GitHub Actions例**：  

  - name: Run build script
    run: kotlinc -script scripts/build_all.kts

<h3>スクリプト管理のメリット</h3>  
- **可読性向上**：整理されたスクリプトで理解しやすい。  
- **メンテナンス効率**：再利用可能な関数で変更が容易。  
- **信頼性向上**：エラー処理やログ出力で問題解決が迅速。  

これらのベストプラクティスを活用することで、Kotlinスクリプトの管理がスムーズになり、複数プロジェクトの効率的な運用が実現できます。
<h2>エラーとトラブルシューティング</h2>  
Kotlinスクリプトを複数プロジェクトの管理に使用する際、さまざまなエラーや問題に遭遇することがあります。これらの問題を素早く解決するために、よくあるエラーとそのトラブルシューティング方法を解説します。

<h3>1. Kotlinスクリプトが実行できない</h3>  
**エラーメッセージ例**：  

**原因**：  
- Kotlinコマンドラインツールがインストールされていない。  
- 実行コマンドが間違っている。

**解決方法**：  
1. Kotlinのインストールを確認します。  

2. スクリプトの実行コマンドが正しいことを確認します。  

<h3>2. Gradleタスクが失敗する</h3>  
**エラーメッセージ例**：  

**原因**：  
- Gradle設定ファイル（`build.gradle.kts`）が正しくない。  
- 実行しているディレクトリが間違っている。

**解決方法**：  
1. 正しいディレクトリでコマンドを実行していることを確認します。  

2. `build.gradle.kts`に正しいタスクが定義されているか確認します。  

<h3>3. ファイル操作でパスが見つからない</h3>  
**エラーメッセージ例**：  

**原因**：  
- 指定したファイルパスが存在しない。  
- 相対パスと絶対パスの指定ミス。

**解決方法**：  
- ファイルパスが正しいか確認し、存在することを確認します。  
- 相対パスを使う場合、スクリプトが実行されるディレクトリを考慮します。

**修正例**：  

<h3>4. 依存関係エラー</h3>  
**エラーメッセージ例**：  

**原因**：  
- リポジトリが正しく設定されていない。  
- ネットワークの問題で依存関係をダウンロードできない。

**解決方法**：  
1. `build.gradle.kts`にリポジトリ設定があることを確認します。  

2. ネットワーク接続を確認し、リポジトリにアクセスできることを確認します。

<h3>5. スクリプトのパフォーマンスが低い</h3>  
**原因**：  
- 無駄な処理が多い。  
- 大量のファイル操作やGradleタスクの実行。

**解決方法**：  
- **処理を並列化**：複数のタスクを並列で実行することでパフォーマンスを向上。  
- **不要な処理の削減**：無駄なファイル操作やログ出力を見直す。

**並列処理の例**：  

<h3>エラー対応時のポイント</h3>  
1. **エラーメッセージを確認**：具体的なエラーメッセージを読み、原因を特定する。  
2. **ログ出力の活用**：スクリプト内にログを追加して、問題箇所を把握する。  
3. **再現手順を整理**：問題が発生する手順を整理し、再現性を確認する。

これらのトラブルシューティング方法を活用することで、Kotlinスクリプトのエラーを迅速に解決し、スムーズに複数プロジェクトを管理できるようになります。
<h2>応用例：CI/CDパイプラインへの統合</h2>  
KotlinスクリプトをCI/CDパイプラインに統合することで、複数プロジェクトのビルド、テスト、デプロイを自動化し、開発フローを効率化できます。ここでは、KotlinスクリプトをGitHub ActionsやJenkinsに組み込む方法を紹介します。

<h3>CI/CDパイプラインとは</h3>  
- **CI（Continuous Integration：継続的インテグレーション）**：コード変更を頻繁に統合し、自動テストで確認するプロセス。  
- **CD（Continuous Deployment/Delivery：継続的デリバリー/デプロイ）**：自動でデプロイするプロセス。

<h3>GitHub ActionsでのKotlinスクリプト活用</h3>  
GitHub Actionsを使用してKotlinスクリプトを実行するCI/CDパイプラインの例です。

**ディレクトリ構成例**：  

**`ci-pipeline.yml`**: GitHub Actionsのワークフローファイル  

steps:
  - name: Checkout code
    uses: actions/checkout@v2

  - name: Set up JDK 11
    uses: actions/setup-java@v2
    with:
      java-version: '11'
      distribution: 'adopt'

  - name: Install Kotlin
    run: |
      sudo apt-get update
      sudo apt-get install -y kotlin

  - name: Build all projects
    run: kotlinc -script scripts/build_all.kts

**`build_all.kts`**: Kotlinスクリプトで複数プロジェクトをビルド  

<h3>JenkinsでのKotlinスクリプト活用</h3>  
JenkinsでもKotlinスクリプトを組み込んだパイプラインを作成できます。

**Jenkinsfile**：  

stages {
    stage('Checkout') {
        steps {
            checkout scm
        }
    }

    stage('Set up Environment') {
        steps {
            sh 'sudo apt-get update && sudo apt-get install -y kotlin'
        }
    }

    stage('Build Projects') {
        steps {
            sh 'kotlinc -script scripts/build_all.kts'
        }
    }
}