351 lines
12 KiB
JavaScript
351 lines
12 KiB
JavaScript
// 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<string, string>}
|
|
*/
|
|
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<Object<string, string>>}
|
|
*/
|
|
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<string, string>}
|
|
*/
|
|
export function readPropertiesSync(filePath = '../version.properties', { encoding = 'utf8' } = {}) {
|
|
const text = fs.readFileSync(filePath, { encoding });
|
|
return parseProperties(text);
|
|
}
|
|
|
|
/**
|
|
* @param {string} [filePath='../version.properties']]
|
|
* @param {Object<string,string>} [props={}]
|
|
* @param {Object} options
|
|
* @param {BufferEncoding} [options.encoding='utf8']
|
|
* @return {Promise<void>}
|
|
*/
|
|
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<string,string>} [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,
|
|
};
|
|
} |