Gradle プラグイン#

3つあります。必要なものだけ入れてください。

plugins {
	application
	id("io.jimble.jte") version "2.7.5"
	id("io.jimble.run") version "2.7.5"
	id("io.jimble.db")  version "2.7.5"
}

**Plugin Portal には出していません。**Maven Central から取るので、 settings.gradle.kts に置き場所を書いてください（jimble new の雛形には入っています）。

pluginManagement {
	repositories {
		mavenCentral()
		gradlePluginPortal()
	}
}

まっさらから書く#

jimble new を使わないなら、この2つを置けば動きます。 下は実際に動かして確かめたものです（gradle build で migrate → codegen → compileJava が繋がり、gradle run で起動します）。

// settings.gradle.kts
pluginManagement {
	repositories {
		mavenCentral()
		gradlePluginPortal()
	}
}

rootProject.name = "memo"

// build.gradle.kts
plugins {
	application
	id("io.jimble.jte") version "2.7.5"   // src/main/jte を使うなら
	id("io.jimble.run") version "2.7.5"   // ホットリロードを使うなら
	id("io.jimble.db")  version "2.7.5"   // DB を使うなら
}

repositories {
	mavenCentral()
}

// jimble は Java 25 で作ってあります。これが無いと依存が解決できません
java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(25)
	}
}

dependencies {
	implementation("io.jimble:jimble-web:2.7.5")

	testImplementation(platform("org.junit:junit-bom:5.11.4"))
	testImplementation("org.junit.jupiter:junit-jupiter")
	testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.withType<Test>().configureEach {
	useJUnitPlatform()
}

// conf/ をリソースに足す。設定もマイグレーションもここから読みます（[設定](./config)）
sourceSets {
	main {
		resources {
			srcDir("conf")
		}
	}
}

application {
	mainClass = "memo.App"
}

jimbleRun {
	mainClass = "memo.App"
}

Dependency resolution is looking for a library compatible with JVM runtime version 21,
but 'io.jimble:jimble-web:2.7.5' is only compatible with JVM runtime version 25 or newer

どれを依存に足すか#

まとめて入るものは書かなくてよいです（jimble-web を足せば jimble-db も jimble-util も付いてきます）。

DB のドライバは要りません（MySQL / MariaDB と PostgreSQL は jimble-db が持っています）。

io.jimble.db#

./gradlew migrate       # 未適用の SQL を当てる
./gradlew codegen       # テーブル定義のクラスを作る（migrate のあと）
./gradlew codegenCheck  # コミットされている生成物がスキーマと合うか見る

中身は マイグレーションとコード生成 を見てください。

jimble {
	sourceRoot   = "src/main/java"   // 生成先
	env          = "local"           // CLI に -Denv=... で渡る
	autoGenerate = true              // compileJava の前に繋ぐか
}

つまりローカルでだけ migrate → codegen → compileJava が繋がります。 CI では繋がらないので、コミットされた生成物でそのままコンパイルできます。

./gradlew build -Pjimble.autoGenerate=true    # CI でも繋ぎたいとき

codegenCheck がずれを見つけると、こう言って落ちます。

コミットされている生成物がスキーマと一致しません（2 件）。codegen を実行してコミットしてください。
  生成物が古いです: db/blog_example/table/post/Post.java
  生成物が足りません: db/blog_example/table/tag/Tag.java

io.jimble.jte#

src/main/jte の .jte を Java に変換します。コンパイルは compileJava がやるので、 テンプレートの型の間違いはビルドで落ちます（テンプレート）。

jte {
	sourceDirectory       = "src/main/jte"
	packageName           = "gg.jte.generated.precompiled"
	contentType           = "Html"    // Html | Plain
	trimControlStructures = true
	htmlCommentsPreserved = false
}

コンパイラ（gg.jte:jte）を持っているのはプラグインだけです。 アプリの実行時クラスパスには jte-runtime しか入りません（要件 D-27）。

io.jimble.run#

./gradlew jimbleRun

仕組みと注意は ホットリロード にあります。ここは設定の一覧です。

jimbleRun {
	mainClass = "my_blog.App"        // 必須
}

見張るのは src と conf（あれば）＋ watchDirs です。

ビルドに失敗したら#

止まりません。ブラウザにそのまま出ます。

直して保存し、リロードすれば続きができます。

AI 向けのタスク#

どの jimble のプラグイン（io.jimble.jte / io.jimble.run / io.jimble.db）を当てても付きます。

jimbleSkills#

jimble new は skill を写して置くので、jimble の版を上げても写しは古いままです。 アプリの AI は古い jimble の説明を読み続けます。版を上げたら流してください。

./gradlew jimbleSkills
./gradlew jimbleSkills --overwrite   # 手で直したもの・控えの無いものも入れ替える

• **手で直した skill は上書きしません。**置いたときの中身のハッシュを .claude/jimble-skills.properties に控えていて、 控えと同じ（jimble が置いたまま）なら入れ替え、違えば触りません
• 控えの無い skill（控えを書くようになる前の jimble new で置いたもの）も、直したかどうか分からないので触りません。 直していなければ --overwrite で入れ替えてください
• **アプリ固有の決まりは skill ではなく AGENTS.md に書きます。**skill を直すと、次の版に揃えられなくなります
• AGENTS.md / CLAUDE.md は無ければ置き、あれば触りません（CLAUDE.md は @AGENTS.md と書いて読み込むだけ）

jimbleCheck#

動かしても黙って間違えるものだけを見ます（起動時に落ちて直し方を言うものは見ません）。 ERROR が1つでもあれば落ち、WARN だけなら落ちません。

[J903 WARN] src/main/java/demo/PostController.java:83  isError() は 2.0 で無くなった（DB の失敗は SqlExecuteException）
    直し方: db.transaction(...) の中なら確定しないことで守られる。分岐したいのは一意制約くらいなので DuplicateKeyException で受ける
    詳しく: https://jimble.io/ja/migrate-2.md

1.x の書き方で、2.0 で消えたもの・型や意味が変わったものも出します（どれも WARN。書き換え先は 2.0 への移行）。

J8xx と J9xx はいつも出します。--target=2.0 は 1.5 のころのスクリプトがそのまま動くように受け付けますが、何もしません。