CLI

nshは、RustまたはTSXでNSHアプリをビルドするためのツールです。アプリをビルドするすべてのサブコマンドは[ENTRY]を受け取ります。これはアプリのディレクトリ(デフォルトはカレントディレクトリなので、cd my-app && nsh runで動作します)で、Rustアプリのルートコンポーネント(nsh.json "root")、TSXアプリのApp.tsx、またはTSXエントリモジュールを実行します。アプリのルートにあるnsh.jsonを読み込み、.nsh/typesの型宣言を更新します。

nsh <COMMAND>

  init         Create an app in Rust or TSX
  build        Build an app: describe a Rust app's crates, or bundle a TSX app and compile it to QuickJS bytecode
  test         Run an app's tests headless, and its Rust crates' with cargo test
  check        Type check an app with TypeScript's native compiler, and its Rust crates with cargo check
  dev          Serve an app to dev hosts (simulators, devices) and push rebuilds
  run          Like dev, and also run the app in a development host
  package      Package an installable app from the prebuilt runtime
  keygen       Create a signing key
  certify      Certify a release key with a root key
  publish      Build an app in release mode and sign it into a package (.nshpkg)
  verify       Verify a package
  symbolicate  Map the positions in a reported error stack to the app's sources
  revoke       Sign a revocation list

nsh <command> --helpはコマンドのフラグを表示します。nsh -V(--version)はバージョンと、ビルド元のGitリビジョンを表示します。

#出力

すべてのコマンドは、ステップごとに1行を出力し、詳細は失敗したときだけ表示します。

✓ built the Rust crate gallery-native (5.0s)
✓ built App.tsx (500 B js, 809 B bytecode, 21ms)
✓ built the development host for the iOS simulator (12.7s)
• iOS Simulator (iPhone 16 Plus) connected, build 1
warn iOS Simulator: image failed: An SSL error has occurred and a secure connection to the server cannot be made.
✓ rebuilt App.tsx (18ms), 1 device

✓は完了したステップ、→は接続先、•はデバイスの動作を表します。warnとerrorの行は問題を示し、通常の行はアプリ自身の出力(console.log)です。ターミナルでは、実行中のステップがスピナーで表示され、行には色が付きます(NO_COLORが設定されている場合を除く)。ファイルにリダイレクトした場合は、結果の行だけが色なしで書き込まれます。 NSHが実行するツール(アプリのRustクレート用のcargo、開発ホスト)の出力は、いずれかが失敗したときにerrorの行の下に表示されます。

-v, --verbose(任意のコマンドで使用可能。NSH_VERBOSE=1も同様)は、すべてを出力された順に表示します。レベルとソースが付いたすべてのログ行、cargoの出力、ホスト自身の出力が対象です。

#nsh init

nsh init [DIR] [--name <NAME>] [--template <ts|rust|mixed>] [--nsh-source <DIR>]

テンプレートからDIR(デフォルトはカレントディレクトリ。存在しない場合は作成されます)にアプリを作成します。--templateを指定しない場合、nsh initはターミナルではどのテンプレートを使うか尋ね(Enterでtsを選択)、それ以外(スクリプト、CI)ではtsを使用します。

テンプレート	作成されるもの
rust	Rustで書かれたアプリ。Cargoプロジェクト(Cargo.toml、ルートコンポーネントを持つsrc/lib.rs、cargo run用のsrc/main.rs)、"rust": "."と"root": "App"を持つnsh.json、tsconfig.jsonと.nsh/typesを持つルートのテストApp.test.tsx、.gitignore、およびREADMEが作成されます。READMEには、後からTSXエントリを追加する方法も記載されています。nsh runとnsh packageは、QuickJSなしですべてのターゲット(ブラウザを含む)でルートをマウントします(nsh testはTypeScriptテスト用にルートを開きます)(Rustでのビルド)。cargo runは、macOS、Windows、Linuxで直接起動します。
ts	TSXアプリ。App.tsx、そのテストApp.test.tsx(nsh test)、nsh.json、tsconfig.json、.gitignore、.nsh/typesが作成されます。既存のファイルは保持され、すべてのファイルがすでに存在する場合にのみ失敗します。
mixed	ルートに専用のRustクレートを持つTSXアプリ。App.tsx、そのテストApp.test.tsx、tsconfig.json、"rust": "."を持つnsh.json、.gitignore、.nsh/types、README、およびApp.tsxと並ぶクレート(Cargo.toml、src/lib.rs)が作成されます。その#[native_module("<name>/native")]は、App.tsxが使用するコンポーネント、モジュール、クラスをエクスポートします。"root"を指定しない場合、App.tsxがエントリになります。

フラグ	説明
--name <NAME>	nsh.jsonに書き込まれる表示名。デフォルトはディレクトリ名です。idはcom.example.<name>(英数字のみ、小文字)になり、クレートのインポート指定子は<name>/native(小文字、単語を-で連結)になります。
--template <TEMPLATE>	rust、ts、またはmixed(上記)。rustとmixedにはRustが必要です。cargo runには、ネイティブデスクトップバックエンドの開発ライブラリも必要です。
--nsh-source <DIR>	rustまたはmixedと併用する場合:クレートは、DIRにあるチェックアウトのNSHクレートにパスで依存し、NSHのソースに対してアプリをビルドします。

rustとmixedのクレートは、CLIのバージョンに対応するcrates.ioのNSHクレートに依存します(--nsh-sourceを指定した場合は、チェックアウトのクレートに依存します)。nshコマンドは、同じクレートからアプリのランナーとホストをビルドします。このようなアプリに対する各コマンドの実行前に、nshはアプリのクレートとNSHのコアから小さなプログラムをビルドして、それらのコンポーネント、モジュール、クラスを記述し、クレートが変更されていればそれを実行します。この記述を使って、CLI自身がアプリのバンドル、コンパイル、型チェック、配信、パッケージ化を行います。Rustアプリのビルドでは、アプリのクレートとNSHのコアだけがコンパイルされます。これらは新しいアプリディレクトリに作成してください。これらのファイルが1つでも存在する場合は、何かが書き込まれる前に競合として報告されます。

RustクレートがGit経由でNSHに依存するアプリは、アプリのロックファイルでCargoが解決したチェックアウトを使用します。生成されるホストはそのチェックアウトを共有します。これには、アプリのCargoパッチによってリダイレクトされたNSHの依存関係も含まれます。

#nsh run

nsh run [ENTRY] [--target catalyst|ios|android|macos|linux|windows|gpui|web] [--device <DEVICE>] [--port <PORT>] [--release] [--limits [<LIMITS>]] [--trace] [--fps] [--name <NAME>] [--window-size <WIDTHxHEIGHT>] [--display <N>]

nsh run my-app                     # a Rust app's root, or a TSX app's App.tsx, on this machine's backend
nsh run my-app --target ios        # in the iOS simulator
nsh run my-app/App.tsx --target web

TSXエントリの場合、nsh runはdevサーバーを(nsh devと同様に)起動し、そこからアプリを読み込む開発ホストを起動して、保存のたびに再ビルドします。Hot Module Replacementは実行中のアプリをその場でパッチします。アプリのログとエラーはターミナルに出力されます。Ctrl-C(またはCatalyst、macOS、Linux、Windows、GPUIのウィンドウを閉じる)で停止します。どのような終了の仕方(Ctrl-C、kill / pkill、エラー)でも、起動したホスト(Catalystアプリ、macOS、Linux、Windows、GPUIのホスト、シミュレータ内の開発ホスト、またはAndroidデバイス上の開発ホスト)は停止されます。

Rustアプリ(nsh.json "root"、Rustでのビルド)は、devサーバーもQuickJSも使わずに実行されます。nsh runは、ルートをマウントした状態でターゲット用のアプリのランナーをビルドして起動し(デスクトップではデバッグビルドで、ログはターミナルに出力されます。シミュレータとAndroidではアプリがインストールされます)、クレートのRustコードが変更されると再度ビルドして再起動します。--target webを指定するとページのアドレスが出力され、開いているページは新しいランタイムを自動的に読み込みます。代わりにTSXエントリを実行するには、そのエントリ(nsh run App.tsx)を指定します。

フラグ	デフォルト	説明
--target <TARGET>	macOSではmacos、Linuxではlinux、Windowsではwindows	catalyst: Mac Catalystホスト。iPhoneサイズのウィンドウ(390×844)。ios: iOSシミュレータ内のホスト。android: AndroidデバイスまたはエミュレータのAndroid上のホスト。macos: AppKitホスト。1200×800のウィンドウ(macOS)。linux: GTKホスト。390×844のウィンドウ(Linux)。windows: Win32ホスト。1200×800のウィンドウ(Windows)。gpui: GPUIホスト。macOS、Windows、Linuxで1200×800のウィンドウとして、GPUIアプリが埋め込んだ場合と同じ形でTSXアプリを表示します(GPUI)。web: 出力されるアドレスにあるdevサーバーのページ(Web)。
--device <DEVICE>		使用するiOSシミュレータを、名前("iPhone 16 Pro")またはUDIDで指定します。デフォルトは、起動済みのもの、なければ最新のiPhoneで、これが起動されます。
--port <PORT>	8790	devサーバーのポート。クリーンアップの完了後、このポートにある以前のNSH開発セッションを置き換えます。
--release		最小化し、デバッグ情報を削除します。リリースバンドルにはHot Module Replacementがなく、保存のたびにアプリが再読み込みされます。
--limits [<LIMITS>]		ホストアプリが設定する制限の範囲内で、アプリを別のアプリに埋め込まれたアプリとして実行します。memoryとstack(KB、MB、またはGB内)、loadとcall(msまたはs内)、および--limits memory=128MB,call=500msなどのnodesが対象です。指定されなかったものは埋め込みのデフォルトのままで、--limitsだけを指定した場合はそれで実行されます(サンドボックスとケイパビリティ)。指定しない場合、アプリはパッケージ化されたアプリと同様に単独で実行されます。TSXエントリのみ。
--trace		ホストが、すべてのコミット(JS、レイアウト、マウントアイテム)のタイミングをターミナルに記録します。
--fps		パフォーマンスモニター。フレームレート、フレームとコミットのコスト、CPU、GPU、メモリを、macOSではアプリの上に表示し(macOS)、macOS、Linux、Windows、iOSでは毎秒1回ログに出力します。
--name <NAME>	nsh.jsonの名前	メニューバーのアプリケーション表示名と、ウィンドウの初期タイトル(--target macos、TSXエントリ)。
--window-size <WIDTHxHEIGHT>	ホストのデフォルト	ポイント単位のウィンドウの初期サイズ(例: 800x600)(--target macos、linux、windows、gpui、TSXエントリ)。
--display <N>	メインディスプレイ	ウィンドウを中央に開くディスプレイ。1はプライマリディスプレイ(メニューバーのあるもの)、2は次のディスプレイ、以降も同様です。該当するディスプレイがない番号を指定した場合は、メインディスプレイに開きます(--target macos、TSXエントリ)。

--target androidを指定した場合、adb devicesが一覧表示する最初のデバイスが使用され、devサーバーのポートはadb reverseでそのデバイスに転送されます。はじめにとdevサーバーとデバッグを参照してください。

置き換えでは、前のセッションがクリーンアップを終えるまで最大10秒待機します。別のプログラムまたは古いNSH CLIがポートを使用している場合は、そのポートを示すエラーになります。複数のアプリを同時に実行するには、異なる--portの値を使用してください。--port 0を指定すると、OSに空きポートを割り当てさせます。

#nsh dev

nsh dev [ENTRY] [--target catalyst|ios|android|macos|linux|windows|gpui|web] [--device <DEVICE>] [--server-only] [--port <PORT>] [--release] [--limits [<LIMITS>]]

devサーバーを起動し、このシステムのネイティブホスト(macOSではAppKit、LinuxではGTK、WindowsではWin32)を開きます。モバイル開発では、--target iosまたは--target androidを明示的に選択してください。--server-onlyは、自分で起動したホストに対してサーバーを提供します。サーバーはアプリをビルドし、エントリのディレクトリを監視して、再ビルドのたびに接続中のホストへプッシュします。--server-onlyを指定すると、このマシン上のホスト用のURLと、デバイス用にLANアドレスごとのURLを出力します。Webランタイムがある場合は、ブラウザがアプリを実行するために開くページも出力されます(Web)。

✓ built App.tsx (3.2 KB js, 9.8 KB bytecode, 21ms)
→ dev server ws://127.0.0.1:8790/ws
  browsers: http://127.0.0.1:8790/
  devices on this network: ws://192.168.1.20:8790/ws
  browsers on this network: http://192.168.1.20:8790/

開発SDK(NativeShellDev.xcframework、nsh-dev.aar)を埋め込んだアプリでは、nsh dev --server-onlyを使用します。--target、--device、--port、--release、--limitsはnsh runと同様に動作します。--server-onlyは、ホストを起動しないサーバーを選択します。

#nsh test

nsh test [PATH] [--filter <NAME>] [--trace] [--fps] [--junit <FILE>] [--target <TARGET>] [--browser <PATH>] [--web-host <JS>] [--display <N>]

アプリのテストをヘッドレスで実行します(テスト)。対象は、PATHにあるテストファイル(*.test.tsx、*.test.ts、nsh/testをインポート)、ディレクトリ(デフォルトはカレントディレクトリ。隠しディレクトリ、node_modules、targetはスキップされます)、またはテストファイルPATHです。専用のRustクレートを持つアプリ(nsh.json "rust": Rustアプリ、またはクレートを持つTSXアプリ)のディレクトリを指定した場合は、まずディレクトリ内の各クレートに対して、そのクレート自身のディレクトリでcargo testを実行し、各Rustテストを、そのテストターゲットのファイル(src/lib.rs › tests::adds)の下に、TypeScriptテストとともに表示して集計します。Rustのテストだけを持つRustアプリも、この方法でテストされます。各テストファイルは専用のエンジンで実行され、テストが開く各アプリは、さらに別の新しいエンジンで実行されます。テストごとに1行を出力し、失敗については、スローされた内容、テストファイル内の位置、画面上のテキストを出力します。失敗が1つでもあると、ゼロ以外のコードで終了します。アプリのエントリ(nsh test App.tsx。Rustアプリの場合はnsh test nsh.json)を指定した場合は、アプリをネットワーク上で開き、1.2秒間実行させて、標準入力で与えられたステップを実行します(await app.press("Add")。appがアプリです)。TSXアプリはCLI自身のプロセスで実行されます。専用のRustクレートを持つアプリは、それらとともにビルドされたヘッドレスランナーで実行され、CLIがそのためのエントリをビルドします。ヘッドレス実行は、テストがアプリをAndroidとして開く場合(openのplatform)を除き、iOSとして動作します。platform.osは"ios"で、ios:クラスとios={{…}}プロパティが適用されます。

✓ App.test.tsx › counts taps (321ms)
✓ 1 test: 1 passed, 0 failed (343ms)

フラグ	説明
--filter <NAME>	名前(それが含まれるdescribeブロックの名前の後の部分)にNAMEを含むテストだけを実行します。クレートの場合はcargo test <NAME>です。
--trace	テストが開くアプリのすべてのマウントバッチを、それが発生したステップ(── press(Add): 7 items)の下に出力するとともに、すべてのコミットの時間(最初のフレーム、ステップ、スクロールのフレームにかかるコスト)も出力します。--targetを指定すると、ホストのバッチとタイミングが出力されます。
--fps	--target linux、macos、windows、またはiosと併用する場合:ホストがパフォーマンスモニターの値(フレームレート、フレームのフェーズ、コミット、CPU、メモリ)を毎秒1回ログに出力し、-vで表示されます。
--junit <FILE>	結果をJUnit XMLレポート(CIサービスがテスト結果を表示する形式)としてFILEにも書き込みます。テストファイルごとにtestsuite、テストごとにtestcaseが出力されます。
--target <TARGET>	テストが開くアプリを、ヘッドレスではなく、このプラットフォームの開発ホストで実行します(macos、linux、windows、gpui、web、ios、android。webはヘッドレスのChrome、Edge、Chromiumで実行します)。ステップはプラットフォーム独自の入力で動作し(テスト)、openはそのオプションをプラットフォームに照らして検証し、対応できないものは拒否します(ERR_NSH_TEST_UNSUPPORTED: iOSとAndroidでのwidthとheight、別の種類のデバイスのplatform)。クレートのRustテストは、--targetなしの実行ではこのマシン上で実行されます。
--browser <PATH>	--target webがアプリを実行するChrome、Edge、またはChromiumの実行ファイル(デフォルトはこのマシンにインストールされているもの)。
--display <N>	--target macosと併用する場合:アプリのウィンドウを中央に開くディスプレイ。1はプライマリディスプレイ(メニューバーのあるもの)、2は次のディスプレイ、以降も同様です。該当するディスプレイがない番号を指定した場合は、メインディスプレイに開きます。デフォルトでは、テスト実行が専用の画面に収まるよう、セカンダリディスプレイ(プライマリ以外で最初のもので、そのミラーではないもの)に開き、ディスプレイが1つだけの場合はプライマリに開きます。テストはどのディスプレイでも同じように実行されます。
--web-host <JS>	ヘッドレスで開かれたアプリが受け取る、Webページのホストモジュール(デフォルトはnsh.json web.hostで、createHost(player)をエクスポートします)。アプリのhost呼び出しに応答し、そのplayer.hostEventはhost.onに到達します(テスト)。ヘッドレス実行のみ。--target webはnsh.jsonのweb.hostを実行します。

#nsh check

nsh check [ENTRY] [--tsc <TSC>] [-- <TSC ARGS>...]

アプリの型チェックを行います。独自の Rust クレートを持つアプリ（nsh.json "rust"）では、まず各クレートをそのディレクトリで cargo check --all-targets によりチェックします（テストも含みます）。Cargo がエラーを出すと、ゼロ以外のコードで終了します。Rust アプリ（"root"）は、その後、TypeScript がある範囲でチェックされます。tsconfig.json（nsh init --template rust が App.test.tsx 用に書き出すもの）があれば、テストファイルも型チェックされます。TypeScript のチェックでは .nsh/types と .nsh/tsconfig.json を更新し、アプリの tsconfig.json を指定して tsc -p <app directory> --noEmit を実行します。ネイティブコンパイラである TypeScript 7 を使うため、Node は不要です。初回実行時に npm レジストリからダウンロードし（約 9 MB）、NSH が記録しているチェックサムと照合したうえで、NSH のキャッシュ（macOS では ~/Library/Caches/nsh、Linux では ~/.cache/nsh、Windows では %LOCALAPPDATA%\nsh、または NSH_CACHE）に保存します。型エラーがあると、ゼロ以外のコードで終了します。tsconfig.json が ./.nsh/tsconfig.json を拡張していない場合は警告します。NSH はこのファイルに TypeScript の設定を置いています（プロジェクト構成）。

フラグ	説明
--tsc <TSC>	代わりにこの tsc を実行します（NSH_TSC でも指定可）。たとえば node_modules のものや、ネットワークのないマシン向けのコピーなどです。
-- <TSC ARGS>	tsc にそのまま渡されます。例: nsh check -- --pretty false。

NSH が生成するファイルは .nsh/ 以下に置かれます。宣言、ランナーのソース、デフォルトのビルド／パッケージ出力は .nsh/out/ に置かれます。Cargo は通常の target/ キャッシュと既存の CARGO_TARGET_DIR の動作をそのまま使い、NSH はこれを移動するための Cargo 設定を追加しません。--out を指定すれば、出力先を引き続き上書きできます。

#nsh build

nsh build [ENTRY] [-o <OUT>] [--release] [--split]

アプリをビルドします。Rust アプリ（nsh.json "root"）では、アプリのクレートをビルドして記述し、app.json と、クレートが同梱するファイル（assets/）を書き出します。ランナーはこのルートをマウントします。TSX アプリでは、アプリをバンドルして QuickJS バイトコードにコンパイルします。これは、NSH を組み込み、バンドルを自分で配布するアプリ向けです。

フラグ	デフォルト	説明
-o, --out <OUT>	.nsh/out	出力ディレクトリ。
--release		最小化し、デバッグ情報を取り除きます。
--split		import() が読み込むものを独自のチャンクファイルに分け、最初にインポートされたときにダウンロードします（Web アプリ。バンドルの分割を参照）。指定しない場合、バンドルにアプリ全体が含まれます。

次のファイルを書き出します。

ファイル	内容
bundle.js	JavaScript としてのバンドル
bundle.js.map	そのソースマップ（スタックトレースは元のソースに対応付けられます）
bundle.nshc	コンパイル済みバイトコードとしてのバンドル。アプリが読み込むものです
<Chunk>.js, <Chunk>.js.map, <Chunk>.nshc	--split 指定時: 各チャンク、そのソースマップ、そのバイトコード（import("./Screen") の場合は Screen.js）
capabilities.json	nsh.json の capabilities（宣言されている場合。なければ削除されます）
assets/	インポートされたすべての画像とフォント。アプリルートからの相対パスに置かれます

#nsh package

nsh package [ENTRY] --target ios|ios-simulator|android|macos|linux|windows|web [-o <OUT>] [flags]

インストール可能なアプリをリリースモードでビルドします。Rust アプリ（nsh.json "root"）は、自身のランナーでパッケージ化されます。ランナーは、あなたのクレートと NSH のクレートから Cargo でビルドされ、ルートをマウントし、QuickJS は使いません（Rust でのビルド）。TSX アプリは、ビルド済みのランタイムでパッケージ化されます。Xcode プロジェクトや Gradle ビルドは不要です。NSH がアプリバンドルを自分で組み立て、iOS では Xcode の actool と codesign、Android では SDK の aapt2、zipalign、apksigner を使います。macOS では codesign により ad hoc 署名された .app を組み立てます（アイコンには sips を使います）。Linux ではランナーをコピーし、tar を含む .tar.gz を書き出します。Windows ではランナーをコピーし、アイコンを埋め込んで .zip を書き出します。ツールは不要です。Web では静的サイトを書き出します。ツールは不要です。メタデータは nsh.json から取得され、フラグで上書きされます。

フラグ	説明
--target <TARGET>	必須。ios: iOS 実機向けの、署名済み .ipa（--sign がなければ署名なしの .app）。ios-simulator: ad hoc 署名された .app。android: 署名済み .apk。macos: ad hoc 署名された .app（macOS）。linux: ディレクトリ <Name>/（実行ファイル、nsh/、.desktop ファイル）と <Name>.tar.gz（Linux）。windows: ディレクトリ <Name>\（<Name>.exe、nsh\）と <Name>.zip（Windows）。web: ディレクトリ <Name>/、静的サイト（index.html と、内容にちなんで名付けられたファイル）（Web）。
-o, --out <OUT>	出力ディレクトリ（デフォルトは .nsh/out）。
--name <NAME>	表示名。
--id <ID>	バンドル識別子。例: com.example.app。
--app-version <VERSION>	バージョン。例: 1.2.0。
--build <BUILD>	ビルド番号。
--icon <ICON>	アプリアイコン。正方形の PNG で、1024×1024 が理想です。
--sign <IDENTITY>	iOS 実機: コード署名 ID。例: "Apple Development: …"。
--profile <FILE>	iOS 実機: プロビジョニングプロファイル（.mobileprovision）。エンタイトルメントはここから取得されます。
--keystore <FILE>	Android: リリース用キーストア。デフォルトは ~/.android/debug.keystore のデバッグキーです（なければ作成されます）。
--key-alias <ALIAS>	Android: キーストア内のキーエイリアス。
--keystore-password <PASSWORD>	Android: キーストアのパスワード。NSH_KEYSTORE_PASSWORD からも読み取られます。
--abi <ABI>	Android: APK の ABI（arm64-v8a、armeabi-v7a、x86_64）。繰り返し指定するか、カンマ区切りで指定します。デフォルトは arm64-v8a と armeabi-v7a で、--run を指定するとデバイスの ABI も加わります。
--run	完了後にアプリをインストールして起動します。シミュレータ（ios-simulator）または接続中の Android デバイスで行います。macos、linux、windows では起動のみ行います。web では、表示されるアドレスでこのマシン上にサイトを配信します。

nsh package my-app --target ios-simulator --run
nsh package my-app --target ios --sign "Apple Development: Jane Doe (ABCDE12345)" --profile dev.mobileprovision
nsh package my-app --target android --keystore release.jks --key-alias upload
nsh package my-app --target macos
nsh package my-app --target linux
nsh package my-app --target windows
nsh package my-app --target web

パッケージングを参照してください。

#署名コマンド

これらのコマンドは、署名付きパッケージ（.nshpkg）を作成・検証します。署名付きパッケージとは、NSH を組み込むアプリが、実行前にダウンロードして検証するアプリバンドルです。署名付きパッケージで、そのモデル（オフラインのルートキーが、特定のアプリ ID に対してリリースキーを認証する）を説明しています。

#nsh keygen

nsh keygen <NAME>

Ed25519 のキーペア <NAME>.secret と <NAME>.pub（例: nsh keygen keys/root）を作成します。ルートの .secret はオフラインで保管してください。アプリは、その .pub を信頼します。

#nsh certify

nsh certify --root <ROOT.secret> --key <KEY.pub> --apps <PATTERN>... [--days <DAYS>] -o <OUT>

ルートキーで、特定のアプリ ID と期間についてリリースキーを認証します。パッケージにはこの証明書が含まれます。

フラグ	説明
--root <ROOT>	ルートの秘密鍵。
--key <KEY>	リリースキーの公開鍵。
--apps <APPS>	署名を許可するアプリ ID: *、com.example.*、または ID。複数回指定できます。
--days <DAYS>	署名を許可する期間（現在から）。デフォルトは 365。
-o, --out <OUT>	書き出す証明書。

#nsh publish

nsh publish [ENTRY] --key <KEY.secret> --cert <CERT> [-o <OUT>] [--id <ID>] [--app-version <V>] [--build <N>]
            [--source-map package|file|none] [--strip-debug] [--min-runtime <VERSION>]

アプリをリリースモードでビルドし、署名してパッケージにします。メタデータは nsh.json から取得され、フラグで上書きされます。

パッケージ（ENTRY は .nshpkg ファイル）が指定された場合は、プラットフォームが自らのアプリのパッケージを独自の 1 つのキーで署名するのと同様に、そのパッケージをこのキーで署名し直します。パッケージのファイルとヘッダーはそのままで、証明書、署名時刻、署名が新しいキーのものになります（署名付きパッケージ）。-o には読み込むパッケージを指定でき、--key、--cert、-o のみが有効です。

フラグ	説明
--key <KEY>	リリースキーの秘密鍵。
--cert <CERT>	その証明書（nsh certify）。
-o, --out <OUT>	書き出すパッケージ。デフォルトは .nsh/out/<id>-<build>.nshpkg。
--id <ID>	アプリ ID。
--app-version <VERSION>	バージョン。
--build <BUILD>	ビルド番号。リリースごとに増やす必要があります。
--source-map <WHERE>	ソースマップの置き場所: package（デフォルト）、file（<package>.map をパッケージの隣に置く）、または none（署名付きパッケージ）。
--strip-debug	行・列テーブルをバイトコードから省きます。サイズは小さくなりますが、エラーのスタックに位置情報が含まれなくなります。
--min-runtime <VERSION>	パッケージを実行できる最低限のランタイム。例: 0.2.0。これより古いランタイムは実行を拒否します。デフォルトはこの CLI のバージョンです（署名付きパッケージ）。

#nsh verify

nsh verify <PACKAGE> [--root <ROOT.pub>]... [--revocations <LIST>]

指定されたルートを信頼するアプリと同じ方法でパッケージを検証します。--root がない場合は、パッケージ自体の署名のみを確認します。パッケージの SHA-256 を出力し、これは nsh revoke --package で指定できます。

#nsh symbolicate

nsh symbolicate <MAP> [INPUT]

パッケージが報告したエラーのバンドル上の位置（bundle.js:LINE:COL）を、元のソースの位置に書き換えて結果を出力します。 MAP はソースマップ（nsh publish --source-map file、bundle.js.map の <package>.map）か、それを含む パッケージです。INPUT はエラーのテキストです（デフォルトは標準入力）。

#nsh revoke

nsh revoke --root <ROOT.secret> [--extend <LIST>] [--sequence <N>] [--key <ID>]... [--package <SHA256>]... -o <OUT>

失効リストに署名します。これは、もう読み込んではならないリリースキーとパッケージのリストです。

フラグ	説明
--root <ROOT>	ルートの秘密鍵。
--extend <EXTEND>	このリスト（最後に公開されたもの）のエントリを引き継ぎます。
--sequence <N>	リストの番号。これまでに公開されたどの番号よりも大きくします。--extend 指定時のデフォルトは、そのリストの番号に 1 を足した値です。
--key <ID>	失効させるリリースキー ID。複数回指定できます。
--package <SHA256>	失効させるパッケージの SHA-256。複数回指定できます。
-o, --out <OUT>	書き出すリスト。

#環境変数

変数	使用するコマンド	説明
ANDROID_HOME, ANDROID_SDK_ROOT	Android ターゲット	Android SDK。フォールバック: ~/Library/Android/sdk。
CARGO_TARGET_DIR	Rust クレートを持つアプリ	アプリのランナーをビルドする場所。デフォルトはアプリの target/。
NSH_KEYSTORE_PASSWORD	package --target android	キーストアのパスワード。
NSH_RUNTIME	run, package	CLI の隣にあるものの代わりに使うランタイムディレクトリ。
NSH_VERBOSE	すべてのコマンド	1: --verbose と同様。
NSH_WASM_BINDGEN	run, package（--target web）	クレートがブラウザ API を呼び出すアプリ向けの wasm-bindgen CLI。デフォルトは PATH にあるもの。
NO_COLOR	すべてのコマンド	設定すると、ターミナルで色を使いません。