deveco-harness 0.1.0

package/skills/deveco-create-project/application/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,63 @@
+/*
+ * 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 { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { window } from '@kit.ArkUI';
+
+const DOMAIN = 0x0000;
+
+export default class EntryAbility extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+    try {
+      this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+    } catch (err) {
+      hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err));
+    }
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
+  }
+
+  onDestroy(): void {
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    // Main window is created, set main page for this ability
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
+
+    windowStage.loadContent('pages/Index', (err) => {
+      if (err.code) {
+        hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
+        return;
+      }
+      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
+    });
+  }
+
+  onWindowStageDestroy(): void {
+    // Main window is destroyed, release UI related resources
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
+  }
+
+  onForeground(): void {
+    // Ability has brought to foreground
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
+  }
+
+  onBackground(): void {
+    // Ability has back to background
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
+  }
+}

package/skills/deveco-create-project/application/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets

@@ -0,0 +1,31 @@
+/*
+ * 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 { hilog } from '@kit.PerformanceAnalysisKit';
+import { BackupExtensionAbility, BundleVersion } from '@kit.CoreFileKit';
+
+const DOMAIN = 0x0000;
+
+export default class EntryBackupAbility extends BackupExtensionAbility {
+  async onBackup() {
+    hilog.info(DOMAIN, 'testTag', 'onBackup ok');
+    await Promise.resolve();
+  }
+
+  async onRestore(bundleVersion: BundleVersion) {
+    hilog.info(DOMAIN, 'testTag', 'onRestore ok %{public}s', JSON.stringify(bundleVersion));
+    await Promise.resolve();
+  }
+}

package/skills/deveco-create-project/application/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+
+@Entry
+@Component
+struct Index {
+  @State message: string = 'Hello World';
+
+  build() {
+    RelativeContainer() {
+      Text(this.message)
+        .id('HelloWorld')
+        .fontSize($r('app.float.page_text_font_size'))
+        .fontWeight(FontWeight.Bold)
+        .alignRules({
+          center: { anchor: '__container__', align: VerticalAlign.Center },
+          middle: { anchor: '__container__', align: HorizontalAlign.Center }
+        })
+        .onClick(() => {
+          this.message = 'Welcome';
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}

package/skills/deveco-create-project/application/entry/src/main/module.json5

@@ -0,0 +1,50 @@
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "description": "$string:module_desc",
+    "mainElement": "EntryAbility",
+    "deviceTypes": [
+      "phone"
+    ],
+    "deliveryWithInstall": true,
+    "installationFree": false,
+    "pages": "$profile:main_pages",
+    "abilities": [
+      {
+        "name": "EntryAbility",
+        "srcEntry": "./ets/entryability/EntryAbility.ets",
+        "description": "$string:EntryAbility_desc",
+        "icon": "$media:layered_image",
+        "label": "$string:EntryAbility_label",
+        "startWindowIcon": "$media:startIcon",
+        "startWindowBackground": "$color:start_window_background",
+        "exported": true,
+        "skills": [
+          {
+            "entities": [
+              "entity.system.home"
+            ],
+            "actions": [
+              "ohos.want.action.home"
+            ]
+          }
+        ]
+      }
+    ],
+    "extensionAbilities": [
+      {
+        "name": "EntryBackupAbility",
+        "srcEntry": "./ets/entrybackupability/EntryBackupAbility.ets",
+        "type": "backup",
+        "exported": false,
+        "metadata": [
+          {
+            "name": "ohos.extension.backup",
+            "resource": "$profile:backup_config"
+          }
+        ],
+      }
+    ]
+  }
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "start_window_background",
+      "value": "#FFFFFF"
+    }
+  ]
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/element/float.json

@@ -0,0 +1,8 @@
+{
+  "float": [
+    {
+      "name": "page_text_font_size",
+      "value": "50fp"
+    }
+  ]
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/element/string.json

@@ -0,0 +1,16 @@
+{
+  "string": [
+    {
+      "name": "module_desc",
+      "value": "module description"
+    },
+    {
+      "name": "EntryAbility_desc",
+      "value": "description"
+    },
+    {
+      "name": "EntryAbility_label",
+      "value": "label"
+    }
+  ]
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/media/layered_image.json

@@ -0,0 +1,7 @@
+{
+  "layered-image":
+  {
+    "background" : "$media:background",
+    "foreground" : "$media:foreground"
+  }
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/profile/backup_config.json

@@ -0,0 +1,3 @@
+{
+  "allowToBackupRestore": true
+}

package/skills/deveco-create-project/application/entry/src/main/resources/base/profile/main_pages.json

@@ -0,0 +1,5 @@
+{
+  "src": [
+    "pages/Index"
+  ]
+}

package/skills/deveco-create-project/application/entry/src/main/resources/dark/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "start_window_background",
+      "value": "#000000"
+    }
+  ]
+}

package/skills/deveco-create-project/application/hvigor/hvigor-config.json5

@@ -0,0 +1,23 @@
+{
+  "modelVersion": "6.0.2",
+  "dependencies": {
+  },
+  "execution": {
+    // "analyze": "normal",                     /* Define the build analyze mode. Value: [ "normal" | "advanced" | "ultrafine" | false ]. Default: "normal" */
+    // "daemon": true,                          /* Enable daemon compilation. Value: [ true | false ]. Default: true */
+    // "incremental": true,                     /* Enable incremental compilation. Value: [ true | false ]. Default: true */
+    // "parallel": true,                        /* Enable parallel compilation. Value: [ true | false ]. Default: true */
+    // "typeCheck": false,                      /* Enable typeCheck. Value: [ true | false ]. Default: false */
+    // "optimizationStrategy": "memory"         /* Define the optimization strategy. Value: [ "memory" | "performance" ]. Default: "memory" */
+  },
+  "logging": {
+    // "level": "info"                          /* Define the log level. Value: [ "debug" | "info" | "warn" | "error" ]. Default: "info" */
+  },
+  "debugging": {
+    // "stacktrace": false                      /* Disable stacktrace compilation. Value: [ true | false ]. Default: false */
+  },
+  "nodeOptions": {
+    // "maxOldSpaceSize": 8192                  /* Enable nodeOptions maxOldSpaceSize compilation. Unit M. Used for the daemon process. Default: 8192*/
+    // "exposeGC": true                         /* Enable to trigger garbage collection explicitly. Default: true*/
+  }
+}

package/skills/deveco-create-project/application/hvigorfile.ts

@@ -0,0 +1,7 @@
+// @ts-nocheck – HarmonyOS template file, only used when copied into a DevEco project
+import { appTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+  system: appTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
+  plugins: []       /* Custom plugin to extend the functionality of Hvigor. */
+}

package/skills/deveco-create-project/application/oh-package.json5

@@ -0,0 +1,10 @@
+{
+  "modelVersion": "6.0.2",
+  "description": "Please describe the basic information.",
+  "dependencies": {
+  },
+  "devDependencies": {
+    "@ohos/hypium": "1.0.25",
+    "@ohos/hamock": "1.0.0"
+  }
+}

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

@@ -0,0 +1,216 @@
+/*
+ * 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.mjs';
+
+const API_CONFIGS = {
+  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',
+];
+
+const APP_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,127}$/;
+
+function parseArgs(argv) {
+  const values = new Map();
+  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) {
+  if (args.apiLevel) {
+    return {
+      apiLevel: args.apiLevel,
+      source: 'user_input',
+    };
+  }
+  return detectApiLevel();
+}
+
+function copyDirectoryContents(sourceDir, targetDir) {
+  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, pairs) {
+  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, apiLevel) {
+  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) {
+  return REQUIRED_FILES.filter((relativePath) => !fs.existsSync(path.join(targetRoot, relativePath)));
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (!APP_NAME_PATTERN.test(args.appName)) {
+    console.error(JSON.stringify({
+      code: 'APP_NAME_INVALID',
+      message: `appName "${args.appName}" is invalid. It must start with an English letter and contain only [A-Za-z0-9_], length 1-128.`,
+      rawAppName: args.appName,
+      hint: '请通过 AskUserQuestion 给出 2-3 个符合规范的 UpperCamelCase 英文候选名（中文按语义翻译，如 "购物车" → ShoppingCart / ShopCart / Cart），让用户选择，然后用新的 --app-name 重新运行脚本。不要自己替用户决定。',
+    }, null, 2));
+    process.exit(4);
+  }
+
+  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);
+
+  if (fs.existsSync(targetRoot) && fs.readdirSync(targetRoot).length > 0) {
+    console.error(JSON.stringify({
+      code: 'PROJECT_EXISTS',
+      message: `Target "${targetRoot}" already exists and is not empty.`,
+      targetRoot,
+      hint: '请通过 AskUserQuestion 向用户提供"覆盖 / 重命名 / 取消"三个选项后再决定如何继续。Never overwrite without explicit user confirmation.',
+    }, null, 2));
+    process.exit(2);
+  }
+
+  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);
+}