// utils/properties.mjs import * as fs from 'node:fs'; import * as fsp from 'node:fs/promises'; import { compareVersionStrings } from './versioning.mjs'; import { generatePropertiesFileTimestamp } from './date.mjs'; /** * @param {string} str * @returns {string} */ function unescapeProperty(str) { let i = 0, out = ''; while (i < str.length) { const ch = str[i++]; if (ch !== '\\') { out += ch; continue; } const next = str[i++]; switch (next) { case 't': out += '\t'; break; case 'n': out += '\n'; break; case 'r': out += '\r'; break; case 'f': out += '\f'; break; case 'u': { const hex = str.slice(i, i + 4); if (/^[0-9a-fA-F] {4}$/.test(hex)) { out += String.fromCharCode(parseInt(hex, 16)); i += 4; } else { // 非法 \u 序列, 按字面量保留 out += '\\u'; } break; } case ':': case '=': case ' ': case '\\': out += next; break; default: // 未知转义, 保留第二个字符 out += next; } } return out; } /** * 将 JS 字符串按 .properties 规范转义 (store 格式) * - 转义: backslash, 空白/控制字符, 分隔符 (= :), 注释首字符 (# !) * - 非 ASCII 均编码为 \uXXXX (与 java.util.Properties.store 对齐) * @param {string} str * @param {boolean} isKey * @returns {string} */ function escapeProperty(str, isKey) { if (!str) return ''; let out = ''; for (let i = 0; i < str.length; i++) { const ch = str[i]; const code = ch.codePointAt(0); // 统一处理非 ASCII 或控制字符 if (code < 0x20 || code > 0x7e) { if (ch === '\t') { out += '\\t'; continue; } if (ch === '\n') { out += '\\n'; continue; } if (ch === '\r') { out += '\\r'; continue; } if (ch === '\f') { out += '\\f'; continue; } // 其他非 ASCII -> \uXXXX const hex = code.toString(16).padStart(4, '0'); out += '\\u' + hex.slice(-4); continue; } switch (ch) { case '\\': out += '\\\\'; break; case '=': case ':': // 在 key 和 value 中都转义, 保证兼容性 out += '\\' + ch; break; case ' ': // key 中任意空格需要转义; value 的前导空格需要转义 if (isKey || out === '') out += '\\ '; else out += ' '; break; case '\t': case '\n': case '\r': case '\f': // 已在上方控制字符分支处理, 这里冗余保护 out += ch === '\t' ? '\\t' : ch === '\n' ? '\\n' : ch === '\r' ? '\\r' : '\\f'; break; case '#': case '!': // 作为 key 时或 value 的首字符, 为避免被解析为注释, 需转义 if (isKey || out === '') out += '\\' + ch; else out += ch; break; default: out += ch; } } return out; } /** * @param {string} text * @returns {Object} */ export function parseProperties(text) { const props = Object.create(null); if (!text) return props; const lines = []; const rawLines = text.split(/\r?\n/); // 合并续行 (以反斜杠结尾且反斜杠未被转义) for (let i = 0; i < rawLines.length; i++) { let line = rawLines[i]; if (line == null) continue; // 去除行尾 CR (兼容 \r\n 已 split 的情况, 一般无需此步) line = line.replace(/\r$/, ''); // 合并续行 while (true) { // 统计结尾连续反斜杠数量, 奇数表示续行 let backslashes = 0; for (let j = line.length - 1; j >= 0 && line[j] === '\\'; j--) backslashes++; const isContinuation = backslashes % 2 === 1; if (!isContinuation) break; const next = rawLines[++i]; if (next == null) break; // 去掉一个续行用的反斜杠, 再拼接后续行, 续行处按规范会吞掉换行 line = line.slice(0, -1) + next; } lines.push(line); } for (const raw of lines) { const line = raw.trim(); if (!line || line.startsWith('#') || line.startsWith('!')) continue; // 键值分隔: 第一个 =/: 或未转义空白 let key = ''; let value = ''; let sepIdx = -1; // 逐字符扫描, 识别未转义的分隔符 let escaped = false; for (let i = 0; i < line.length; i++) { const ch = line[i]; if (!escaped && (ch === '=' || ch === ':')) { sepIdx = i; break; } if (!escaped && /\s/.test(ch)) { sepIdx = i; break; } escaped = ch === '\\' && !escaped; if (!escaped && ch !== '\\') escaped = false; } if (sepIdx === -1) { key = line; value = ''; } else { key = line.slice(0, sepIdx); value = line.slice(sepIdx + 1); // 如果分隔符是空白, value 应该从第一个非空白处开始 if (/^\s$/.test(line[sepIdx])) { value = value.replace(/^\s+/, ''); } } key = key.replace(/\s+$/, ''); // 规范里 key 前部空白可作为分隔符, 末尾空白需要去掉 const k = unescapeProperty(key); const v = unescapeProperty(value.trim()); if (k) props[k] = v; } return props; } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {Promise>} */ export async function readProperties(filePath = '../version.properties', { encoding = 'utf8' } = {}) { const text = await fsp.readFile(filePath, { encoding }); return parseProperties(text); } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {Object} */ export function readPropertiesSync(filePath = '../version.properties', { encoding = 'utf8' } = {}) { const text = fs.readFileSync(filePath, { encoding }); return parseProperties(text); } /** * @param {string} [filePath='../version.properties']] * @param {Object} [props={}] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @return {Promise} */ export async function writeProperties(filePath = '../version.properties', props = {}, { encoding = 'utf8' } = {}) { const lines = []; for (const key in props) { const value = props[key]; if (value == null) continue; const k = escapeProperty(String(key), true); const v = escapeProperty(String(value), false); lines.push(`${k}=${v}`); } lines.unshift(generatePropertiesFileTimestamp()); const text = lines.join('\n') + '\n'; return fsp.writeFile(filePath, text, { encoding }); } /** * @param {string} [filePath='../version.properties']] * @param {Object} [props={}] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @return {void} */ export function writePropertiesSync(filePath = '../version.properties', props = {}, { encoding = 'utf8' } = {}) { const lines = []; for (const key in props) { const value = props[key]; if (value == null) continue; const k = escapeProperty(String(key), true); const v = escapeProperty(String(value), false); lines.push(`${k}=${v}`); } lines.unshift(generatePropertiesFileTimestamp()); const text = lines.join('\n') + '\n'; return fs.writeFileSync(filePath, text, { encoding }); } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {string} */ export function getMinSupportedAgpVersion(filePath = '../version.properties', { encoding = 'utf8' } = {}) { let minSupportedVersion = null; Object.entries(readPropertiesSync(filePath, { encoding })).forEach(([ key, value ]) => { if (!/agp.version.*min.supported|min.supported.*agp.version/i.test(key)) return; if (minSupportedVersion === null || compareVersionStrings(value, minSupportedVersion) < 0) { minSupportedVersion = value; } }); return minSupportedVersion ?? '8.0'; } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {string} */ export function getMinSupportedGradleVersion(filePath = '../version.properties', { encoding = 'utf8' } = {}) { let minSupportedVersion = null; Object.entries(readPropertiesSync(filePath, { encoding })).forEach(([ key, value ]) => { if (!/gradle.version.*min.supported|min.supported.*gradle.version/i.test(key)) return; if (minSupportedVersion === null || compareVersionStrings(value, minSupportedVersion) < 0) { minSupportedVersion = value; } }); return minSupportedVersion ?? '8.0'; } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {number} */ export function getMinSupportedJavaVersionInt(filePath = '../version.properties', { encoding = 'utf8' } = {}) { return getJavaVersionInfo(filePath, { encoding }).minSupportedJavaVersionInt; } /** * @param {string} [filePath='../version.properties'] * @param {Object} options * @param {BufferEncoding} [options.encoding='utf8'] * @returns {{ currentJavaVersionInt: number, minSupportedJavaVersionInt: number, minSuggestedJavaVersionInt: number, maxSupportedJavaVersionInt: number }} */ export function getJavaVersionInfo(filePath = '../version.properties', { encoding = 'utf8' } = {}) { let currentVersion = 0; let minSuggestedVersion = 19; let minSupportedVersion = 17; let maxSupportedVersion = 0; Object.entries(readPropertiesSync(filePath, { encoding })).forEach(([ key, value ]) => { const versionNumber = parseInt(value, 10); if (/^java.version$/i.test(key)) { currentVersion = Math.max(currentVersion, versionNumber); } else if (/java.version.*min.suggested|min.suggested.*java.version/i.test(key)) { minSuggestedVersion = Math.min(minSuggestedVersion, versionNumber); } else if (/java.version.*min.supported|min.supported.*java.version/i.test(key)) { minSupportedVersion = Math.min(minSupportedVersion, versionNumber); } else if (/java.version.*max.supported|max.supported.*java.version/i.test(key)) { maxSupportedVersion = Math.max(maxSupportedVersion, versionNumber); } }); return { currentJavaVersionInt: currentVersion, minSuggestedJavaVersionInt: minSuggestedVersion, minSupportedJavaVersionInt: minSupportedVersion, maxSupportedJavaVersionInt: maxSupportedVersion, }; }