deveco-harness 0.1.0

package/skills/deveco-create-project/scripts/copy-template.ts

@@ -0,0 +1,214 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { detectApiLevel } from './detect-sdk';
+
+type Args = {
+  projectPath: string;
+  appName: string;
+  bundleName: string;
+  apiLevel?: number;
+  templateDir: string;
+};
+
+type ApiConfig = {
+  sdkVersion: string;
+  modelVersion: string;
+};
+
+type Source = 'user_input' | 'sdk_pkg' | 'fallback';
+
+type Resolved = {
+  apiLevel: number;
+  source: Source;
+  detectedFrom?: string;
+  devecoHome?: string;
+};
+
+const API_CONFIGS: Record<number, ApiConfig> = {
+  17: { sdkVersion: '5.0.5(17)', modelVersion: '5.0.5' },
+  18: { sdkVersion: '5.0.6(18)', modelVersion: '5.0.6' },
+  19: { sdkVersion: '5.0.7(19)', modelVersion: '5.0.7' },
+  20: { sdkVersion: '6.0.0(20)', modelVersion: '6.0.0' },
+  21: { sdkVersion: '6.0.1(21)', modelVersion: '6.0.1' },
+  22: { sdkVersion: '6.0.2(22)', modelVersion: '6.0.2' },
+  23: { sdkVersion: '6.1.0(23)', modelVersion: '6.1.0' },
+  24: { sdkVersion: '6.1.1(24)', modelVersion: '6.1.1' },
+};
+
+const REQUIRED_FILES = [
+  'build-profile.json5',
+  'AppScope/resources/base/media/layered_image.json',
+  'AppScope/resources/base/media/background.png',
+  'AppScope/resources/base/media/foreground.png',
+  'entry/src/main/resources/base/media/layered_image.json',
+  'entry/src/main/resources/base/media/background.png',
+  'entry/src/main/resources/base/media/foreground.png',
+];
+
+function parseArgs(argv: string[]): Args {
+  const values = new Map<string, string>();
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith('--')) {
+      continue;
+    }
+    const key = token.slice(2);
+    const value = argv[index + 1];
+    if (!value || value.startsWith('--')) {
+      throw new Error(`Missing value for --${key}`);
+    }
+    values.set(key, value);
+    index += 1;
+  }
+
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const templateDir = values.get('template-dir') ??
+    path.resolve(scriptDir, '../../deveco-create-project/application');
+  const projectPath = values.get('project-path');
+  const appName = values.get('app-name');
+  const bundleName = values.get('bundle-name') ?? (appName
+    ? `com.example.${appName.toLowerCase()}`
+    : undefined);
+  const apiLevelRaw = values.get('api-level');
+  const apiLevel = apiLevelRaw ? Number(apiLevelRaw) : undefined;
+
+  if (!projectPath) {
+    throw new Error('Missing required argument --project-path');
+  }
+  if (!appName) {
+    throw new Error('Missing required argument --app-name');
+  }
+  if (!bundleName) {
+    throw new Error('Missing required argument --bundle-name');
+  }
+  if (apiLevelRaw && (apiLevel === undefined || !Number.isInteger(apiLevel) || !API_CONFIGS[apiLevel])) {
+    throw new Error(`Unsupported apiLevel: ${apiLevelRaw}`);
+  }
+
+  return {
+    projectPath: path.resolve(projectPath),
+    appName,
+    bundleName,
+    apiLevel,
+    templateDir: path.resolve(templateDir),
+  };
+}
+
+async function resolve(args: Args): Promise<Resolved> {
+  if (args.apiLevel) {
+    return {
+      apiLevel: args.apiLevel,
+      source: 'user_input',
+    };
+  }
+  return detectApiLevel();
+}
+
+function copyDirectoryContents(sourceDir: string, targetDir: string): void {
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
+    const sourcePath = path.join(sourceDir, entry.name);
+    const targetPath = path.join(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectoryContents(sourcePath, targetPath);
+      continue;
+    }
+    if (fs.existsSync(targetPath)) {
+      continue;
+    }
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.copyFileSync(sourcePath, targetPath);
+  }
+}
+
+function replaceInFile(filePath: string, pairs: Array<[string, string]>): void {
+  const original = fs.readFileSync(filePath, 'utf-8');
+  let next = original;
+  for (const [from, to] of pairs) {
+    next = next.replaceAll(from, to);
+  }
+  if (next !== original) {
+    fs.writeFileSync(filePath, next, 'utf-8');
+  }
+}
+
+function updateApiLevel(targetRoot: string, apiLevel: number): void {
+  if (apiLevel === 22) {
+    return;
+  }
+  const config = API_CONFIGS[apiLevel];
+  replaceInFile(path.join(targetRoot, 'build-profile.json5'), [
+    ['6.0.2(22)', config.sdkVersion],
+  ]);
+  replaceInFile(path.join(targetRoot, 'hvigor/hvigor-config.json5'), [
+    ['6.0.2', config.modelVersion],
+  ]);
+  replaceInFile(path.join(targetRoot, 'oh-package.json5'), [
+    ['6.0.2', config.modelVersion],
+  ]);
+}
+
+function verifyFiles(targetRoot: string): string[] {
+  return REQUIRED_FILES.filter((relativePath) => !fs.existsSync(path.join(targetRoot, relativePath)));
+}
+
+async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2));
+  const resolved = await resolve(args);
+  if (!fs.existsSync(args.templateDir)) {
+    throw new Error(`Template directory not found: ${args.templateDir}`);
+  }
+
+  fs.mkdirSync(args.projectPath, { recursive: true });
+  const targetRoot = path.join(args.projectPath, args.appName);
+  copyDirectoryContents(args.templateDir, targetRoot);
+
+  replaceInFile(path.join(targetRoot, 'AppScope/resources/base/element/string.json'), [
+    ['MyApplication', args.appName],
+  ]);
+  replaceInFile(path.join(targetRoot, 'AppScope/app.json5'), [
+    ['com.example.myapplication', args.bundleName],
+  ]);
+  updateApiLevel(targetRoot, resolved.apiLevel);
+
+  const missingFiles = verifyFiles(targetRoot);
+  if (missingFiles.length > 0) {
+    throw new Error(`Template copy incomplete. Missing files: ${missingFiles.join(', ')}`);
+  }
+
+  console.log(JSON.stringify({
+    projectRoot: targetRoot,
+    appName: args.appName,
+    bundleName: args.bundleName,
+    apiLevel: resolved.apiLevel,
+    source: resolved.source,
+    detectedFrom: resolved.detectedFrom,
+    devecoHome: resolved.devecoHome,
+    verified: true,
+  }, null, 2));
+}
+
+try {
+  await main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(message);
+  process.exit(1);
+}

package/skills/deveco-create-project/scripts/detect-sdk.mjs

@@ -0,0 +1,82 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+
+function envPath() {
+  return String(process.env.DEVECO_HOME || '').trim();
+}
+
+async function isDir(file) {
+  if (!file) {
+    return false;
+  }
+  return fs.stat(file)
+    .then((info) => info.isDirectory())
+    .catch(() => false);
+}
+
+function nodePath(home) {
+  return process.platform === 'win32'
+    ? path.join(home, 'tools', 'node', 'node.exe')
+    : path.join(home, 'tools', 'node', 'bin', 'node');
+}
+
+async function findDevEcoHome() {
+  const env = envPath();
+  if (env && (await isDir(env)) && (await exists(nodePath(env)))) {
+    return env;
+  }
+}
+
+function ok(apiLevel) {
+  return Number.isInteger(apiLevel) && apiLevel >= 17 && apiLevel <= 24;
+}
+
+function parse(raw) {
+  if (typeof raw !== 'string') {
+    return;
+  }
+  const apiLevel = Number(raw);
+  if (!ok(apiLevel)) {
+    return;
+  }
+  return apiLevel;
+}
+
+async function json(file) {
+  if (!(await exists(file))) {
+    return;
+  }
+  return JSON.parse(await fs.readFile(file, 'utf8'));
+}
+
+async function exists(file) {
+  return fs.access(file).then(() => true).catch(() => false);
+}
+
+export async function detectApiLevel() {
+  const home = await findDevEcoHome().catch(() => undefined);
+  if (!home) {
+    return {
+      apiLevel: 22,
+      source: 'fallback',
+    };
+  }
+
+  const sdk = path.join(home, 'sdk', 'default', 'sdk-pkg.json');
+  const first = await json(sdk).catch(() => undefined);
+  const firstLevel = parse(first?.data?.apiVersion);
+  if (firstLevel) {
+    return {
+      apiLevel: firstLevel,
+      source: 'sdk_pkg',
+      detectedFrom: sdk,
+      devecoHome: home,
+    };
+  }
+
+  return {
+    apiLevel: 22,
+    source: 'fallback',
+    devecoHome: home,
+  };
+}

package/skills/deveco-create-project/scripts/detect-sdk.ts

@@ -0,0 +1,95 @@
+import path from 'node:path';
+
+type Source = 'sdk_pkg' | 'fallback';
+
+type Result = {
+  apiLevel: number;
+  source: Source;
+  detectedFrom?: string;
+  devecoHome?: string;
+};
+
+type Pkg = {
+  data?: {
+    apiVersion?: unknown;
+  };
+  apiVersion?: unknown;
+};
+
+function envPath() {
+  return String(process.env.DEVECO_HOME || '').trim();
+}
+
+async function isDir(file: string) {
+  if (!file) {
+    return false;
+  }
+  return Bun.file(file)
+    .stat()
+    .then((info) => info.isDirectory())
+    .catch(() => false);
+}
+
+function nodePath(home: string) {
+  return process.platform === 'win32'
+    ? path.join(home, 'tools', 'node', 'node.exe')
+    : path.join(home, 'tools', 'node', 'bin', 'node');
+}
+
+async function findDevEcoHome() {
+  const env = envPath();
+  if (env && (await isDir(env)) && (await Bun.file(nodePath(env)).exists())) {
+    return env;
+  }
+}
+
+function ok(apiLevel: number) {
+  return Number.isInteger(apiLevel) && apiLevel >= 17 && apiLevel <= 24;
+}
+
+function parse(raw: unknown) {
+  if (typeof raw !== 'string') {
+    return;
+  }
+  const apiLevel = Number(raw);
+  if (!ok(apiLevel)) {
+    return;
+  }
+  return apiLevel;
+}
+
+async function json(file: string) {
+  const item = Bun.file(file);
+  if (!(await item.exists())) {
+    return;
+  }
+  return item.json() as Promise<Pkg>;
+}
+
+export async function detectApiLevel(): Promise<Result> {
+  const home = await findDevEcoHome().catch(() => undefined);
+  if (!home) {
+    return {
+      apiLevel: 22,
+      source: 'fallback',
+    };
+  }
+
+  const sdk = path.join(home, 'sdk', 'default', 'sdk-pkg.json');
+  const first = await json(sdk).catch(() => undefined);
+  const firstLevel = parse(first?.data?.apiVersion);
+  if (firstLevel) {
+    return {
+      apiLevel: firstLevel,
+      source: 'sdk_pkg',
+      detectedFrom: sdk,
+      devecoHome: home,
+    };
+  }
+
+  return {
+    apiLevel: 22,
+    source: 'fallback',
+    devecoHome: home,
+  };
+}