# oh_dotnet.helpbox.cross

**Repository Path**: lightsever/oh_dotnet.helpbox.cross

## Basic Information

- **Project Name**: oh_dotnet.helpbox.cross
- **Description**: oh_dotnet 的 windows macos linux 等跨平台版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-28
- **Last Updated**: 2026-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# oh_dotnet.helpbox.cross

OHOS ARM64 的 .NET 11 交叉发布工具分发仓库。这里只保存下载安装资料，源码、构建、SDK 适配和打包流程在主仓库 `tools/oh-dotnet/`。

## 使用

安装后在 net11.0 项目中执行：

```sh
oh_dotnet publish -p:PublishAot=true
oh_dotnet publish -p:PublishReadyToRun=true
```

默认 ohos-arm64、Release、自包含。无需创建 targets 文件；系统有匹配 SDK 就复用，没有则自动安装官方 .NET 11 RC1 到用户目录。NativeAOT 首次使用时自动准备官方 OHOS NDK，也可用 OHOS_NDK_HOME 指向已有 native 目录。不会修改系统 SDK。

本地 Windows 安装：

```powershell
.\dl11\install.ps1 -Source "$PWD\dl11"
```

Linux/macOS 本地安装：

```sh
OH_DOTNET_SOURCE="$PWD/dl11" sh dl11/install.sh
```

远程入口为 `dl11/install.ps1`（Windows）或 `dl11/install.sh`（Linux/macOS）；脚本默认使用该仓库 master 的匿名 raw 地址。源码与构建脚本位于主仓库 dotnet11-rc1 分支。

## dl11

- install.ps1 / install.sh：安装引导，按需获取并校验官方 SDK。
- bootstrap.zip / bootstrap.tar.gz 及校验值：托管下载器与发布入口，不含 .NET SDK。
- sdk-platforms.json：微软官方 SDK 地址和 SHA-512。
- win-x64 / linux-x64 / osx-x64 / osx-arm64：分别包含 SDK 下载信息、INDEX、8 MiB 产物分块。

工具包采用逐块及整包 SHA-256 校验，包含 OHOS 目标资产、对应宿主 ILC 依赖与发布配置。SDK、NDK 单独从官方来源取得。开发源码和打包脚本不放在本仓库。

## 验收边界

Windows x64 安装和双架构发布入口已验证。ohos-x64 的 NativeAOT 与专用零 JIT R2R 已在 Pura X View 通过 HDC shell 验收，包括异常、泛型、GC、动态代码拒绝、R2R 加载日志和纯 IL 解释器探针。另已安装真实 HAP，在应用 UID 下通过 N-API 直接调用 NativeAOT 共享库及零 JIT CoreCLR，NativeAOT 77/77、R2R 80/80 全量场景通过，R2R 包含纯 IL DLL 热加载/卸载。Linux/macOS 分发包已生成，尚未在各自主机执行。

Windows 包的 ARM64/x64 均已接入源码构建的零 JIT runtime。ARM64 当前以解释器执行（ReadyToRun=0），x64 以 R2R 为主并支持纯 IL 解释器兜底。显式 OhosZeroJit=false 仅用于普通 JIT 对照。Composite/single-file 暂不支持。HAP 已验证国际化、加密、HTTPS/SslStream 和 DLL 热加载/卸载。其他宿主资料仍为旧版本，不据此声明已同步 ARM64 零 JIT 能力。

## Windows 更新（2026-09-29）

`dl11/win-x64` 已更新 ARM64 NativeAOT 启动库、独立 ZeroJit runtime pack、配套解释器 CoreLib 和 ICU/OpenSSL/CA，隔离 AOT 与 CoreCLR 引用包。安装后可直接 `oh_dotnet publish -r ohos-arm64 -p:PublishReadyToRun=true`，不再手工替换 .so/.dll；应用可生成 R2R，但 ARM64 当前执行策略为零 JIT 解释器。

新版包安装后自动发布、签名和安装的 ARM64 HAP 已通过 AOT 77/77、零 JIT 80/80。命令行实机验收按用户要求免除，HAP 为验收口径。Linux/macOS 下载资料与公共安装入口此次未更新。Windows 包校验值、使用与边界见 [Windows 下载说明](dl11/win-x64/README.md)。


选择 x86_64 模拟器目标：

```powershell
oh_dotnet publish YourApp.csproj -r ohos-x64 -p:PublishAot=true
oh_dotnet publish YourApp.csproj -r ohos-x64 -p:PublishReadyToRun=true
```

默认仍为 ohos-arm64。每个宿主包同时包含两种目标的独立资产，系统 SDK 无需修改。