@oniroproject/core 0.10.0 → 0.12.0

package/README.md

@@ -99,7 +99,7 @@ The injection points every frontend implements, plus their defaults.
 | `getInstalledSdks` | `(config) => string[]` | Versions with at least one OS-folder install. |
 | `removeSdk` | `(config, api) => boolean` | Remove an installed SDK by API level across OS folders. |
 | `detectProjectSdkVersion` | `(projectRoot, logger?) => number \| undefined` | Read `compileSdkVersion` from a project's `build-profile.json5`. |
-| `ALL_SDKS` / `SdkRelease` | — | Catalog of known releases (`version`, `api`, `tarballStrip`). |
+| `ALL_SDKS` / `SdkRelease` | — | Catalog of known releases (`version`, `api`, `tarballStrip`, optional `archiveSuffix`). |
 | `OHOS_URL_BASE` | — | Default SDK mirror base URL. |
 | `getOsFolder()` / `getSdkFilename(version?)` | — | Map the host platform to its OS folder / SDK archive (`SdkArchiveInfo`). |
 
@@ -182,7 +182,7 @@ The injection-safe primitives every device operation builds on (`spawn` with `sh
 
 | Export | Signature | Description |
 | --- | --- | --- |
-| `reboot` | `(RebootOptions) => Promise<void>` | `system` (via `param set ohos.startup.powerctrl reboot`), `bootloader`, or `recovery`. Optionally waits for a bundle to return (and reconnects a TCP target across the reboot). |
+| `reboot` | `(RebootOptions) => Promise<void>` | `system` (via `param set ohos.startup.powerctrl reboot`), `bootloader`, or `recovery`. Optionally waits for a bundle to return (and reconnects a TCP target across the reboot, restarting the hdc server if it keeps the dead session). |
 | `waitForBundle` | `(WaitForBundleOptions) => Promise<void>` | Poll `pidof <bundle>` until it has a clean numeric pid. |
 | `waitForBoot` | `(WaitForBootOptions) => Promise<void>` | Poll until reachable (and optionally `untilPidOf` has a pid). Tolerant of the reboot disconnect. |
 | `waitForCondition` | `(WaitForConditionOptions) => Promise<void>` | Generic deadline + poll + heartbeat loop. A throwing probe counts as "not yet". |
@@ -265,6 +265,39 @@ The injection-safe primitives every device operation builds on (`spawn` with `sh
 | `decideInstallMethod` / `decideReboot` | — | The pure (tested) decision functions behind `applyChanges`. |
 | `diffHapAssets` / `diffEntryNames` | — | Diff two HAP archives' file manifests (drives the cache-invalidation reboot). |
 
+### HarmonyOS
+
+HarmonyOS support is additive: a project is HarmonyOS only when its product declares
+`runtimeOS: "HarmonyOS"`, and every OpenHarmony API behaves as before. `buildHap`,
+`runHvigorw` and `createScaffold` pick the HarmonyOS SDK for such projects themselves.
+
+| Export | Description |
+| --- | --- |
+| `detectRuntimeOs(projectDir, productName?)` | `'HarmonyOS'` or `'OpenHarmony'`, from `build-profile.json5`. |
+| `findHarmonyOsSdk({ config, logger? })` / `requireHarmonyOsSdk(...)` | Locate a HarmonyOS SDK (`harmonyosSdkPath`, then DevEco Studio's default location, then `cmdToolsPath` when it is the HarmonyOS edition), with its release as `version`, e.g. `6.1.1(24)`; `null` or an actionable error when there is none. |
+| `harmonyOsSdkLabelForApi(api)`, `HARMONYOS_SDK_VERSIONS` | The `"<version>(<api>)"` label HarmonyOS products declare. |
+| `createHarmonyOsSession(opts)` | `login` / `logout` / `getUserInfo` / `listTeams` / `resolveAgcAuth` / `getDeveloperAgreement` for a Huawei developer account. The token is stored encrypted, with the account's region. |
+| `harmonyOsAutoSign(opts)` | Keystore + CSR → AGC debug certificate → device registration → debug profile → `build-profile.json5`, reusing still-valid material. |
+| `readProvisionProfile(path)` | Bundle name, team, expiry, devices and ACLs of a `.p7b`. |
+| `HUAWEI_SITES` | Each region's sign-in and AppGallery Connect hosts. |
+
+```ts
+import { createHarmonyOsSession, harmonyOsAutoSign, staticConfig } from '@oniroproject/core';
+
+const config = staticConfig();
+const session = createHarmonyOsSession({ config, onLoginUrl: (url) => console.log(url) });
+if (!(await session.getUserInfo())) await session.login();
+
+const result = await harmonyOsAutoSign({ config, session, projectDir: '/path/to/project' });
+console.log(result.paths.profilePath, result.deviceIds);
+```
+
+Signing calls private, undocumented AppGallery Connect APIs, and needs a Huawei developer
+account that is real-name verified or has accepted the HUAWEI Developer Basic Service
+Agreement. Accounts from every region work: calls go to the account's own region, as in
+DevEco Studio. Parts of this subtree are adapted from the MIT-licensed
+`openharmony-sig/deveco-cli`; see [`src/harmonyos/NOTICE.md`](src/harmonyos/NOTICE.md).
+
 ## Conventions
 
 - **Configuration.** Pass a `ConfigProvider`. `staticConfig({...})` is the quick path; a frontend can read settings, env vars, etc. Unset keys fall back to `defaultPaths`.