From f85e0439b814409822e37ea29922d07d61db0e2f Mon Sep 17 00:00:00 2001 From: claude-bot Date: Fri, 17 Jul 2026 18:35:40 +0900 Subject: [PATCH] =?UTF-8?q?feat(server):=20JDK=20=ED=83=90=EC=83=89=20?= =?UTF-8?q?=EC=9A=B0=EC=84=A0=EC=88=9C=EC=9C=84=20=EC=9E=AC=EC=A0=95?= =?UTF-8?q?=EC=9D=98=20(.mc=5Fcustom=20=E2=86=92=20=ED=99=98=EA=B2=BD?= =?UTF-8?q?=EB=B3=80=EC=88=98=20=E2=86=92=20Program=20Files)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 요청 사양대로 탐색 순서 변경: ① .mc_custom/jdk(설치기 자동설치 위치)가 있으면 먼저 사용(권장이면 match, 아니면 경고) ② 환경변수(JAVA_HOME/JDK_HOME)가 권장 버전이면 사용 ③ 기본 폴더 C:\Program Files\Java 에 권장 버전 있으면 사용 ④ 없으면 환경변수 자바(없으면 Program Files 자바)로 폴백 + "권장과 다름" 경고 소스별 후보 수집 헬퍼(mcCustom/env/programFiles) 분리. 문서도 갱신. 0.4.8→0.4.9. Co-Authored-By: Claude Opus 4.7 --- docs/installer.md | 8 +++- package.json | 2 +- src/installer/main.ts | 106 ++++++++++++++++++++++++++++++------------ 3 files changed, 83 insertions(+), 33 deletions(-) diff --git a/docs/installer.md b/docs/installer.md index dc27186..e4a414e 100644 --- a/docs/installer.md +++ b/docs/installer.md @@ -29,8 +29,12 @@ ### 3-2. JDK 확인 - 각 음악퀴즈(pack)는 사이트 편집기에서 **권장 JDK 버전**(예: Java 25)을 지정합니다. 편집기 목록은 Adoptium(Temurin)에서 실제 배포되는 버전을 불러오며, "자세히 보기"로 비-LTS·스냅샷까지 확인할 수 있습니다. 설치기는 이 권장 버전을 기준으로 동작합니다. -- 탐색 순서: **① 기본 자바 설치 위치 `C:\Program Files\Java` → ② 환경변수(`JAVA_HOME` / `JDK_HOME`) → ③ 설치기 자동 설치 위치(`%APPDATA%\.mc_custom\jdk`, 구버전 `%APPDATA%\jdk` 호환)** 순으로 훑어, **권장 버전과 정확히 일치하는 JDK 를 우선 선택**합니다. -- 권장 버전이 없으면 컴퓨터에 있는 **다른 JDK(가장 높은 버전)** 를 대신 고르되, "권장 버전과 달라 서버가 정상 실행되지 않을 수 있다"는 **경고**를 함께 띄웁니다. 직접 선택/입력한 경로도 "다음" 에서 검증해, 권장과 다르면 경고 후 동의(확인) 시에만 진행합니다(무조건 차단이 아니라 경고+동의). +- 탐색 순서: + 1. **설치기 자동 설치 위치 `%APPDATA%\.mc_custom\jdk`**(구버전 `%APPDATA%\jdk` 호환)에 JDK 가 있으면 **가장 먼저 사용**합니다(권장 버전이면 그대로, 혹시 다른 버전이면 경고). + 2. 없으면 **환경변수(`JAVA_HOME` / `JDK_HOME`)** 의 JDK 가 **권장 버전이면** 사용합니다. + 3. 그래도 없으면 **기본 폴더 `C:\Program Files\Java`** 에서 **권장 버전**을 찾아 사용합니다. + 4. 권장 버전을 어디서도 못 찾으면 **환경변수 자바(없으면 Program Files 자바)로 폴백**하고, "권장 버전과 달라 서버가 정상 실행되지 않을 수 있다"는 **경고**를 띄웁니다. +- 직접 선택/입력한 경로도 "다음" 에서 검증해, 권장과 다르면 경고 후 동의(확인) 시에만 진행합니다(무조건 차단이 아니라 경고+동의). 아무 JDK 도 없으면 자동 설치로 유도합니다. - **자동 설치** 버튼을 누르면 Adoptium Temurin(권장 버전) Windows x64 zip 을 받아 **`%APPDATA%\.mc_custom\jdk\temurin-<권장>\`** 에 풀어 사용합니다. (`.mc_custom` 안에 두므로 "음악퀴즈 파일제거" 도구로 한 번에 정리됩니다. `MC_CUSTOM_DIR` 로 폴더명을 바꾼 경우 그 폴더 아래 `jdk`.) - 설치 중 같은 버튼이 "설치 취소" 로 바뀌고, 누르면 다운로드를 즉시 중단하고 부분 파일을 정리합니다. - 서버 zip 의 `run.bat` 이 시스템 PATH 의 `java` 를 그대로 쓰면 낡은 자바로 실행돼 실패할 수 있어, 설치기가 준비/선택한 JDK 의 `java` 를 쓰도록 `run.bat` 을 자동으로 수정합니다(자동 설치 JDK 는 `%APPDATA%` 전개형 경로라 한글 사용자명에도 안전). diff --git a/package.json b/package.json index ebc710e..de208c8 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "minecraft-music-quiz-installer", - "version": "0.4.8", + "version": "0.4.9", "description": "마인크래프트 음악퀴즈 간편설치기 + 관리 사이트", "main": "dist/installer/main.js", "scripts": { diff --git a/src/installer/main.ts b/src/installer/main.ts index a5531a5..954addb 100644 --- a/src/installer/main.ts +++ b/src/installer/main.ts @@ -334,42 +334,88 @@ function jdkHomesUnder(parent: string): string[] { return out } -/** - * 컴퓨터에 설치된 JDK 홈 목록을 우선순위대로 모은다(중복 제거). - * 순서: ① 기본 자바 설치 위치 C:\Program Files\Java → ② 환경변수(JAVA_HOME/JDK_HOME) - * → ③ 설치기 자동 설치 위치(.mc_custom/jdk, 구버전 %APPDATA%/jdk 호환). - */ -function collectJdkHomes(): string[] { - const homes: string[] = [] - const push = (h: string): void => { - if (h && !homes.some((x) => x.toLowerCase() === h.toLowerCase())) homes.push(h) +interface JdkEntry { home: string; major: number } + +/** 홈 목록 → {home, major} 목록(중복/버전0 제거). */ +function homesToEntries(homes: string[]): JdkEntry[] { + const javaName = process.platform === 'win32' ? 'java.exe' : 'java' + const seen = new Set() + const out: JdkEntry[] = [] + for (const home of homes) { + const key = home.toLowerCase() + if (seen.has(key)) continue + seen.add(key) + const major = getJavaMajor(path.join(home, 'bin', javaName)) + if (major > 0) out.push({ home, major }) } - for (const h of jdkHomesUnder('C:\\Program Files\\Java')) push(h) - for (const env of [process.env.JAVA_HOME, process.env.JDK_HOME]) { - if (env) push(resolveJdkHome(env)) - } - for (const base of [installerJdkRoot(), path.join(getAppDataDir(), 'jdk')]) { - for (const h of jdkHomesUnder(base)) push(h) - } - return homes + return out } -// 권장 JDK 를 우선 찾는다. C:\Program Files\Java → 환경변수 → 설치기 자동설치 위치를 -// 훑어, ① 권장 버전과 정확히 일치하는 JDK 가 있으면 그걸 쓰고(match=true), -// ② 없으면 가장 높은 버전을 대신 고르되 "권장과 다름"(match=false)으로 표시해 렌더러가 -// 경고를 띄우게 한다. ③ 아무 JDK 도 없으면 not found → 자동 설치 유도. +/** 설치기 자동 설치 위치(.mc_custom/jdk, 구버전 %APPDATA%/jdk 호환)의 JDK 들. */ +function mcCustomJdkEntries(): JdkEntry[] { + const homes: string[] = [] + for (const base of [installerJdkRoot(), path.join(getAppDataDir(), 'jdk')]) { + homes.push(...jdkHomesUnder(base)) + } + return homesToEntries(homes) +} + +/** 환경변수(JAVA_HOME/JDK_HOME)에 등록된 JDK 들. */ +function envJdkEntries(): JdkEntry[] { + const homes: string[] = [] + for (const env of [process.env.JAVA_HOME, process.env.JDK_HOME]) { + if (env) { + const h = resolveJdkHome(env) + if (h) homes.push(h) + } + } + return homesToEntries(homes) +} + +/** 기본 자바 설치 위치 C:\Program Files\Java 아래의 JDK 들. */ +function programFilesJdkEntries(): JdkEntry[] { + return homesToEntries(jdkHomesUnder('C:\\Program Files\\Java')) +} + +// JDK 탐색 우선순위(요청 사양): +// ① .mc_custom/jdk(설치기가 설치해둔 위치)가 있으면 먼저 사용 — 권장 버전이면 그대로, +// 혹시 다른 버전이면 경고(match=false). +// ② 환경변수(JAVA_HOME/JDK_HOME) 가 권장 버전이면 사용. +// ③ 기본 폴더 C:\Program Files\Java 에 권장 버전이 있으면 사용. +// ④ 없으면 환경변수 자바로 폴백하고 "권장과 다름" 경고(match=false). +// (환경변수 자바도 없으면 Program Files 자바로 폴백, 그것도 없으면 not found → 자동 설치 유도.) ipcMain.handle('jdk:detect', async (_event, recommendedInput?: number) => { const required = normalizeRecommendedJdk(recommendedInput) - const javaName = process.platform === 'win32' ? 'java.exe' : 'java' - const found = collectJdkHomes() - .map((home) => ({ home, major: getJavaMajor(path.join(home, 'bin', javaName)) })) - .filter((x) => x.major > 0) + const recommended = (entries: JdkEntry[]): JdkEntry | undefined => entries.find((e) => e.major === required) + const best = (entries: JdkEntry[]): JdkEntry => entries.slice().sort((a, b) => b.major - a.major)[0] - const exact = found.find((x) => x.major === required) - if (exact) return { found: true, path: exact.home, major: required, match: true } - if (found.length > 0) { - const best = found.slice().sort((a, b) => b.major - a.major)[0] - return { found: true, path: best.home, major: best.major, match: false } + // ① .mc_custom/jdk 우선. + const mc = mcCustomJdkEntries() + if (mc.length > 0) { + const rec = recommended(mc) + if (rec) return { found: true, path: rec.home, major: required, match: true } + const b = best(mc) + return { found: true, path: b.home, major: b.major, match: false } + } + + // ② 환경변수 JDK 가 권장 버전이면 사용. + const env = envJdkEntries() + const envRec = recommended(env) + if (envRec) return { found: true, path: envRec.home, major: required, match: true } + + // ③ 기본 폴더(Program Files\Java)에 권장 버전이 있으면 사용. + const pf = programFilesJdkEntries() + const pfRec = recommended(pf) + if (pfRec) return { found: true, path: pfRec.home, major: required, match: true } + + // ④ 폴백: 환경변수 자바 → (없으면) Program Files 자바 + 경고. + if (env.length > 0) { + const b = best(env) + return { found: true, path: b.home, major: b.major, match: false } + } + if (pf.length > 0) { + const b = best(pf) + return { found: true, path: b.home, major: b.major, match: false } } return { found: false, path: '', major: required, match: false } })