Even Hub CLI 是 Even Realities 提供的命令行工具,用于登录账号、初始化应用清单、生成开发二维码以及打包应用。安装方式:npm install -D @evenrealities/evenhub-cli(推荐作为开发依赖),或 npm install -g @evenrealities/evenhub-cli 全局安装,也可用 npx @evenrealities/evenhub-cli <command> 免安装运行。当前版本 v0.1.11。作为开发依赖时用 npx evenhub <command>,全局安装后直接用 evenhub <command>。
主要命令:evenhub login 登录 Even Hub 账号并本地保存凭据,可用 -e/--email 指定邮箱。evenhub init 生成 app.json 起始清单,支持 -d/--directory 指定目录、-o/--output 指定输出路径。evenhub qr 是主要开发命令,生成指向本地开发服务器的二维码,自动检测本地 IP 并记住上次设置;用手机 Even Realities App 扫码后应用在眼镜上加载并支持热重载,支持 --url、-i/--ip、-p/--port、--path、--https/--http、-e/--external、-s/--scale、--clear 等选项。evenhub pack 打包应用用于分发,用法如 evenhub pack app.json dist -o myapp.ehpk,支持 --no-ignore 包含隐藏文件、-c/--check 检查 package_id 是否可用。另提供 bash、zsh、fish 的 shell 补全。
app.json 必填字段包括 package_id(反向域名、小写、无连字符、至少两段)、edition(须为 "202601")、name(最多 20 字符)、version(x.y.z)、min_app_version、min_sdk_version、entrypoint、permissions(对象数组,可为空)、supported_languages(en、de、fr、es、it、zh、ja、ko)。权限对象需含 name 与 desc,whitelist 仅对 network 有效;有效权限名:network、location、g2-microphone、phone-microphone、album、camera。常见错误是误将 permissions 写成键值映射。打包排错涵盖 package id 格式、名称长度、版本格式、缺失版本字段、权限格式、语言代码、入口文件缺失及项目文件夹不存在等。