企业官网建设流程全解析

[鸿蒙PC命令行移植适配]移植rust三方库starship到鸿蒙PC的完整实践

欢迎加入【开源鸿蒙PC社区】，一起共建鸿蒙化C/C++三方库生态。

前言

starship是由 starship 社区维护的极简、极速、无限可定制的 Shell 提示符，采用 Rust 语言编写。它适用于任何 Shell，能在你输入命令的同时展示 Git 分支、Node.js 版本、Python 虚拟环境、Docker 上下文、命令耗时等信息，无需额外配置即可获得美观实用的终端提示。starship 内置丰富的模块化设计，支持高度自定义，同时提供闪电般的执行速度，是提升终端使用体验的利器。

前置条件

系列索引

一、环境配置

1 OpenHarmony SDK 安装

1.1 下载 SDK（环境搭建）

1. 在浏览器中打开 DCP 每日构建列表：https://dcp.openharmony.cn/workbench/cicd/dailybuild/dailylist
2. 在列表中按本机操作系统选择对应产物（名称随版本变化，以页面为准）：

下载到本机后解压（请将下面文件名替换为你实际下载的包名）：

cd~# Linux / macOS 示例（包名以 DCP 页面为准）tar-zvxf<你下载的-sdk-xxx>.tar.gz

Windows 请使用资源管理器或 7-Zip 等工具解压对应.zip/.tar.gz包。

说明：每日构建会更新版本与文件名，不要固定使用旧文档中的直链；以 DCP 页面上当前可下载的 SDK 包为准。解压后若顶层目录名不是ohos-sdk，可将该目录移动或软链为~/ohos-sdk（或 Windows 下放到固定路径），与下文OHOS-SDK配置一致。

再进入ohos-sdk根目录解压（文件名以darwin目录下为准，下例版本号仅作演示）：

cd~/ohos-sdk# Linux / macOS；Windows 请先 cd 到 OHOS_SDK 目录unzipnative-darwin-arm64-6.0.0.46-Beta1.zipunziptoolchains-darwin-arm64-6.0.0.46-Beta1.zip

Windows 可对两个 zip右键解压到当前文件夹，或使用tar/Expand-Archive等工具解压到ohos-sdk根目录。

解压完成后，应得到native/、toolchains/等目录（含llvm、sysroot、hnpcli等），再配置2.1.3中的环境变量。

1.2 SDK 目录结构

ohos-sdk/ ├── native/ │ ├── llvm/bin/ # 编译器工具链 │ ├── sysroot/ # 系统根目录（头文件和库） │ └── build-tools/ # 构建工具 └── toolchains/ └── hnpcli # HNP打包工具

1.3 环境变量配置

编辑~/.zshrc（如果使用 zsh）或~/.bash_profile（如果使用 bash）：

# OpenHarmony SDK 路径exportOHOS_SDK=~/ohos-sdk# 添加到 PATHexportPATH="$OHOS_SDK/native/llvm/bin:$PATH"exportPATH="$OHOS_SDK/native/build-tools/cmake/bin:$PATH"exportPATH="$OHOS_SDK/toolchains/bin:$PATH"# 验证source~/.zshrc# 或 source ~/.bash_profile

1.4 验证 SDK 配置

# 检查 SDK 路径echo$OHOS_SDK# 检查工具是否在 PATH 中whichclangwhichcmakewhichhnpcli# 检查 SDK 工具目录ls$OHOS_SDK/native/llvm/bin/ls$OHOS_SDK/native/build-tools/cmake/bin/ls$OHOS_SDK/toolchains/# 验证工具版本clang--versioncmake--versionhnpcli--version

2 Rust 工具链安装

2.1 安装 Rust

# 安装 Rust（如果未安装）curl--proto'=https'--tlsv1.2-sSfhttps://sh.rustup.rs|shsource~/.cargo/env# 验证安装rustc--versioncargo--version

2.2 配置 Rust 环境变量

编辑~/.zshrc（如果使用 zsh）或~/.bash_profile（如果使用 bash）：

# Rust 环境变量（通常由 rustup 自动添加）source~/.cargo/env# 验证source~/.zshrc# 或 source ~/.bash_profilerustc--versioncargo--version

二、适配步骤

1. 分析starship构建特性

starship由Rust语言编写，使用Cargo作为构建系统。编译后产出的二进制命令为starship。

核心特性

1. 极致的性能表现

   ​ 采用 Rust 零开销抽象，启动延迟极低（毫秒级），即使在低速终端或远程会话中也几乎无感知。相比使用 Node.js、Python 等语言编写的传统提示符工具，starship 在执行速度上具有压倒性优势。

2. 模块化的信息展示

   ​ 内置超过 30 个预置模块，支持显示 Git 分支与状态、编程语言版本（Node.js、Rust、Python、Go、Java 等）、Docker 上下文、命令执行耗时、包版本、当前目录等信息，开箱即用。

3. 无限可定制的配置

   ​ 通过~/.config/starship.toml配置文件，可精确控制每个模块的开关、显示顺序、颜色、前缀后缀、格式模板等；社区提供大量预设主题，支持一键导入。

4. 跨 Shell 与跨平台支持

   ​ 兼容 Bash、Zsh、Fish、PowerShell、Ion、Tcsh、Xonsh、Nu、Elvish 等主流 Shell，支持 Linux、macOS、Windows 全平台运行。只需安装主程序并在 Shell 配置中启用即可。

5. 智能环境检测

   ​ 自动检测当前目录的项目类型和环境上下文：进入 Git 仓库时显示分支和状态，进入 Python 项目时显示虚拟环境和版本，检测到 Docker 时显示容器上下文，无需手动切换配置。

6. 丰富的视觉与交互设计

   ​ 支持自定义颜色主题、Nerd Font 图标、模块分组和条件显示；命令执行超时时自动显示耗时模块，支持错误码提示，提供友好且高效的终端使用体验。

2. 创建适配项目

参考前置条件列表完成lycium_plusplus交叉框架编译环境搭建，以及lycium_plusplus交叉框架代码克隆，在lycium_plusplus/RustAdapt创建目标库starship适配目录为ohos-starship。

为什么是ohos-starship？为了和源库名称做区分，表示该库用于ohos设备。

ohos-starship创建可以借助编辑器工具（如VSCode）或者使用文件夹在lycium_plusplus/RustAdapt目录下创建目标库适配目录ohos-starship，也可以执行以下命令进行创建。

# 我将交叉编译框架克隆在根目录，此处可改为正确的目录地址cd~/lycium_plusplus/RustAdaptmkdirohos-starship

3. 编写HPKBUILD

然后将lycium/template/HPKBUILD.cargo拷贝到RustAdapt/ohos-starship目录下，并重命名为HPKBUILD，HPKBUILD是lycium交叉编译框架完成编译构建的核心配置文件，定义包的元信息、依赖、构建和打包逻辑。需要根据模板在HPKBUILD开头声明starship的基本信息，这些字段被lycium用于下载、组织和记录：

# lycium_plusplus/RustAdapt/ohos-starship/HPKBUILDpkgname=starship# 库名pkgver=1.25.1# 库版本pkgrel=0# 发布号pkgdesc="☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!"# 库描述url="https://github.com/starship/starship"# 官网链接archs=("arm64-v8a")# cpu 架构license=("ISC")depends=()# 依赖库的目录名 必须保证被依赖的库的archs是当前库的archs的超集makedepends=("cargo""rustc")# 构建库时的依赖工具->需要用户安装的工具source="https://github.com/starship/starship/archive/refs/tags/v${pkgver}.tar.gz"# 库源码下载链接downloadpackage=true# 是否自动下载压缩包，如若不写默认 true. (应对一些特殊情况，代码只能 git clone (项目中依赖 submoudle ))autounpack=true# 是否自动解压，如若不写默认 true, 如果为 false 则需要用户在 prepare 函数中自行解压buildtools=cargo# 编译方法: cmake(默认) | configure | cargo | 其它则不在此注入 buildargs，由 build() 自行处理builddir=starship-${pkgver}# 源码压缩包解压后目录名 编译目录名packagename=$builddir.tar.gz# 压缩包名

还需要修改package函数中编译完成后的二进制文件名称，starship项目编译完成后，会产出一个名为starship的二进制文件（在Cargo.toml的[package]中name = "starship"定义），此处需要将cp target/${OHOS_RUST_TARGET}/release/xxx改为cp target/${OHOS_RUST_TARGET}/release/starship并复制到安装目录。

# 打包安装package(){# 进入 Rust 项目目录（和编译时同一个目录）cd$builddir# 定义安装路径：鸿蒙库的安装目录DEST="$LYCIUM_ROOT/usr/$pkgname/$ARCH"# 创建安装目录bin 文件夹mkdir-p$DEST/bin/# 【关键】把编译好的 Rust 程序 → 复制到目标目录的 bin 文件夹cptarget/${OHOS_RUST_TARGET}/release/starship"$DEST/bin/"cd$OLDPWD}

4 HNP 打包配置

在lycium_plusplus/RustAdapt/ohos-starship目录下创建hnp.json文件，因为在HPKBUILD中存在archive函数，用于将产物打包为output/<arch>/<pkgname>_<ver>.tar.gz，或执行 HNP 打包，详细介绍可参考系列索引-构建执行与产物获取。

{"type":"hnp-config","name":"starship","version":"1.25.1","install":{}}

5 交叉编译并解决可能存在的问题

HPKBUILD中函数不做改变，在lycium_plusplus/lycium目录下打开终端工具，输入./build.sh ohos-starship进行第一次交叉编译。会出现以下错误：

ld.lld: error: undefined symbol: __xpg_strerror_r>>>referenced by... starship-....rcgu.o>>>(_$LT$errno..Errno$u20$as$u20$core..fmt..Display$GT$::fmt::...)

**问题原因：**errno crate（v0.2.8）在目标 aarch64-unknown-linux-ohos 上调用 glibc 专有的 __xpg_strerror_r 符号，而 OHOS 基于 musl libc 不提供该符号，导致链接失败。

解决方法：

• prepare()中生成 C 包装文件ohos_strerror_compat.c，将__xpg_strerror_r转发到 musl 原生支持的strerror_r
• build()中用 OHOS 交叉编译器（${CC}）编译该 .c → .o，并通过RUSTFLAGS的-C link-arg=传递给 cargo 链接器

修改HPKBUILD中的prepare方法和build方法之后重新执行交叉编译命令：

# 为编译设置环境，如设置环境变量，创建编译目录等prepare(){cd$builddir# OHOS (musl libc) 不提供 glibc 专有的 __xpg_strerror_r 符号；# errno crate 在某些版本会引入该符号，导致链接失败。# 提供一个 C 包装函数，编译后传入 cargo 链接器。cat>ohos_strerror_compat.c<<'COMPAT_EOF' int __xpg_strerror_r(int errnum, char *buf, unsigned long buflen) { return strerror_r(errnum, buf, buflen); } COMPAT_EOFcd${OLDPWD}}# ${OHOS_SDK} oh sdk安装路径# $ARCH 编译的架构是 archs 的遍历# $LYCIUM_ROOT/usr/$pkgname/$ARCH 安装到顶层目录的usr/$pkgname/$ARCH# 执行编译构建的命令build(){# 进入编译工作目录（Rust 项目源码所在文件夹）cd$builddir# CC 由 cargodependpath → envset.sh 中的 setarm64ENV 注入（OHOS 交叉编译器）# 编译 musl 兼容层（提供 __xpg_strerror_r → strerror_r 转发）${CC:?}-c-oohos_strerror_compat.o ohos_strerror_compat.cexportRUSTFLAGS="${RUSTFLAGS}-C link-arg=$(pwd)/ohos_strerror_compat.o"# 【核心编译命令】正式编译 Rust 项目# --release ：编译正式发布版（优化、速度快）# --locked ：严格使用 Cargo.lock 锁定的依赖版本，保证编译一致# --target ：指定编译目标架构（鸿蒙：aarch64-unknown-linux-ohos）# ${OHOS_RUST_TARGET:?} ：必须有这个环境变量，否则直接报错退出cargobuild--release--locked--target"${OHOS_RUST_TARGET:?}"# 对最关键一步的退出码进行判断ret=$?cd$OLDPWDreturn$ret}

如果提示ALL JOBS DONE!!!表示当前交叉编译没有问题，编译后的产物，可以在lycium/usr/目录和out/arm64-v8目录下查看。

三、 在鸿蒙PC上验证交叉编译后的starship命令是否可用

将lycium_plusplus/lycium/usr/starship/arm64-v8a/bin/starship二进制文件传到鸿蒙PC上，方式有多种，可以通过聊天软件。macos设备可以在App Store下载【鸿蒙星河互联】，通过分享方式将starship二进制文件发送到鸿蒙PC设备上，这种方式需要鸿蒙PC开启华为分享为所有人可见。在鸿蒙PC右下角会弹出接受弹窗，选择"接受"或者"另存为"，接受starship二进制文件。接受后的二进制文件是不可以直接运行的，哪怕使用chmod +x starship这种方式授权也是无法运行的。需要给二进制文件进行签名后才可以，在鸿蒙 PC 侧执行前涉及二进制签名流程，可参考《鸿蒙PC端二进制文件签名命令行使用指南》。打开鸿蒙PC终端，输入以下命令为starship签名授权。

# 进入starship所在目录cdDesktop# 执行签名binary-sign-tool sign-inFilestarship-outFilestarship-selfSign"1"# 授予权限chmod+x starship# 查看starship版本./starship--version# 查看starship帮助./starship--help# 初始化 starship 配置（生成默认配置文件 ~/.config/starship.toml）./starship initbash--print-full-init# 列出预设的社区主题./starship preset--list# 应用一款预设主题（例如 nerd-font-symbols）./starship preset nerd-font-symbols-o~/.config/starship.toml# 以 JSON 格式输出当前提示符模块信息./starship print-config

四、 FAQ

执行签名命令出现"zsh: command not found: binary-sign-tool"提示。

需要在应用市场搜索DevBox并安装，DevBox提供了一些开发者常用命令，主要包含文件和目录操作命令、网络命令、构建命令、签名工具等。