--- url: https://nsh.dev/ja/docs/platforms description: "NSH が動作するプラットフォーム: iOS、Android、macOS、Windows、Linux、GPUI、Web。それぞれに専用のバックエンドがあります。各プラットフォームで Rust または TSX アプリを実行、パッケージ化、埋め込む方法と、必要な要件を説明します。" --- # プラットフォームの概要 NSH は、スマートフォン、デスクトップ、Web で動作します。対応するのは iOS、Android、macOS、Windows、Linux、GPUI、Web ページです。各プラットフォームには独自のバックエンドがあり、そのプラットフォーム自身の UI で描画します。そのため、アプリは iPhone では UIKit のビュー、Mac では AppKit のビュー、Linux では GTK 4 のウィジェット、GPUI アプリでは GPUI の要素、ブラウザーでは HTML になり、テキスト、入力、アクセシビリティ、ダークモードもそのプラットフォームのものが使われます。バックエンドより上の層はすべて共通です。リアクティブグラフ、レンダラー、Taffy レイアウト、コンポーネント、ネイティブモジュールはどこでも同じ Rust コードなので、1 つのアプリがすべてのプラットフォームで動きます。Rust で書かれたアプリは、そのコードとあなたのクレートだけで構成され、JavaScript VM は使いません。TSX アプリは、その上の QuickJS でモジュールを実行します([Rust でのビルド](https://nsh.dev/translations/ja/docs/rust.md))。 どのプラットフォームでも、アプリの使い方は次の 2 通りです。そのプラットフォーム向けのインストール可能なアプリとしてパッケージ化する(`nsh package`)か、ホストが Rust ルートをリンクするか TSX を実行時に読み込むかを問わず、独自のネイティブアプリに埋め込みます。開発には `nsh run` を使います(Rust の編集はアプリを再ビルドして再起動し、TSX の編集はホットアップデートされます)。 ## 概要一覧 | プラットフォーム | バックエンド、テキスト | 動作環境 | 開発 | パッケージ | |---|---|---|---|---| | [iOS](https://nsh.dev/translations/ja/docs/ios.md) | UIKit、CoreText | iOS 15.0 以降、実機とシミュレーター | `nsh run --target ios` | `.app`(シミュレーター)、署名付き `.ipa` | | [Android](https://nsh.dev/translations/ja/docs/android.md) | Android ビュー、`StaticLayout` | Android 9(API 28)以降、`arm64-v8a`、`armeabi-v7a`、`x86_64` | `nsh run --target android` | 署名付き `.apk` | | [macOS](https://nsh.dev/translations/ja/docs/macos.md) | AppKit と Core Animation、CoreText | macOS 14 以降 | `nsh run --target macos` | アドホック署名付き `.app` | | [Windows](https://nsh.dev/translations/ja/docs/windows.md) | Direct2D で描画する Win32 ウィンドウ、DirectWrite | Windows 10 1809 以降、Windows 11 | `nsh run`(Windows でのデフォルト) | ディレクトリと `.zip` | | [Linux](https://nsh.dev/translations/ja/docs/linux.md) | GTK 4 ウィジェット、Pango | GTK 4.14 以降 | `nsh run`(Linux でのデフォルト) | ディレクトリと `.tar.gz` | | [GPUI](https://nsh.dev/translations/ja/docs/gpui.md) | GPUI、GPUI のテキストシステム | macOS、Windows、Linux(Vulkan) | GPUI アプリ内。TSX は `nsh run --target gpui` でも可 | 埋め込み先の GPUI アプリの中 | | [Web](https://nsh.dev/translations/ja/docs/web.md) | HTML と CSS、ブラウザーのフォント | モダンブラウザー、デスクトップとスマートフォン | `nsh run --target web` | 静的サイト | - **[GPUI](https://nsh.dev/translations/ja/docs/gpui.md)** は、姉妹プロジェクトである GPUI Kit のフレームワーク [GPUI](https://gpui-kit.com) でアプリを描画します。macOS、Windows、Linux のいずれでも同じです。GPUI アプリや GPUI Kit アプリに埋め込むためのバックエンドであり、それらのアプリは `AppView` を自身の要素ツリーに配置します。スタンドアロンのデスクトップアプリは、各 OS 固有のバックエンド(AppKit、Win32、GTK 4)で実行とパッケージ化を行います。 - **[Web](https://nsh.dev/translations/ja/docs/web.md)** は、アプリをブラウザーのページ内で HTML として描画します。`nsh package --target web` は、任意の Web サーバーや CDN 向けに静的サイトを公開します。その際、Rust アプリのエンジンとクレートは WebAssembly にコンパイルされます。独自のページには `createPlayer` または iframe でアプリを埋め込めます。このサイトのライブデモと[プレイグラウンド](/playground)も Web バックエンドで動いています。 - **Mac Catalyst** は、開発用に、Mac 上の iPhone サイズ(390×844)のウィンドウで iOS バックエンドを実行します。アプリがスマートフォンでどう見えるかを確認するには、`--target catalyst` で選択します。 ## 開発とパッケージ化 `nsh run` は、`--target` を指定しない場合、そのマシン自身のプラットフォームを選びます。macOS では AppKit、Linux では GTK ウィンドウ、Windows では Win32 ウィンドウです。スマートフォンへはコンピューターから接続します。iOS は Xcode を入れた Mac から、Android は Android SDK を入れた macOS、Linux、Windows から利用できます([インストール](https://nsh.dev/translations/ja/docs/installation.md#what-works-where))。 Rust アプリ(その `nsh.json` が `"root"` コンポーネントを指定するもの)は、そのディレクトリから実行とパッケージ化を行います。`nsh` は、あなたのクレートを使い、QuickJS なしで、対象ターゲット向けのアプリ専用ランナーをビルドします。TSX アプリはエントリーを指定します。 ```sh # A Rust app, from its directory nsh run --target macos # or ios, android, windows, linux, web, catalyst nsh package --target macos # or ios, ios-simulator, android, windows, linux, web # A TSX app nsh run App.tsx --target macos # or ios, android, windows, linux, gpui, web, catalyst nsh package App.tsx --target macos ``` 各デスクトップ OS は、実行するマシン向けにビルドされた自身のバックエンドでアプリをパッケージ化します。Mac アプリは Mac で、Windows アプリは Windows で、Linux アプリは Linux でパッケージ化してください。各ターゲットの出力、署名、アイコンについては[パッケージング](https://nsh.dev/translations/ja/docs/packaging.md)を参照してください。 ## ネイティブアプリへの埋め込み | プラットフォーム | ホストビュー | 実行内容 | 提供形態 | ホスト言語 | |---|---|---|---|---| | macOS | `AppView`(`NSView`) | Rust ルート、TSX バンドル | `nsh-platform-macos` クレート | Rust | | Windows | `AppView`(子ウィンドウ) | Rust ルート、TSX バンドル | `nsh-platform-windows` クレート | Rust | | Linux | `AppView`(GTK ウィジェット) | Rust ルート、TSX バンドル | `nsh-platform-linux` クレート | Rust | | GPUI(macOS、Windows、Linux) | `AppView`(GPUI ビュー) | Rust ルート、TSX バンドル、署名付きパッケージ | `nsh-platform-gpui` クレート | Rust | | iOS | `AppView`(`UIView`) | Rust ルート、TSX バンドル | `nsh-platform-ios` クレート | Rust | | iOS | `NshAppView`(`UIView`) | TSX バンドル、署名付きパッケージ | `NativeShell.xcframework` | Swift | | Android | `NshView`(`FrameLayout`) | TSX バンドル、署名付きパッケージ | `nsh.aar` | Java または Kotlin | | Web | `createPlayer`(ページ要素)または iframe | TSX バンドル。Rust アプリは公開されたサイトとして | `nsh package --target web` のランタイムファイル | JavaScript または HTML | Rust ホストは、Rust ルート(`Root::of::()`)を `AppSource::Rust` または `App::Rust` としてマウントし、`set_ui_sets` でアプリの UI セットをエンジンに渡します。これにより、ホストが読み込む TSX はアプリ独自のコンポーネントとモジュールをインポートできます。各ビューは 1 つのエンジンであり、1 つのアプリが複数のビューを表示できます。ホストは、アプリが使えるように独自のネイティブビューをすべてのプラットフォームで登録します([ネイティブコンポーネント](https://nsh.dev/translations/ja/docs/native-components.md))。 > [!NOTE] > Rust ホストは、NSH リポジトリのプラットフォームクレートを使って NSH を埋め込みます。macOS、Windows、Linux の `AppView` は、デフォルトの制限のもとで、アプリ自身のファイル(またはソースコード)からバンドルを読み込みます。GPUI クレートと iOS および Android の SDK は、[署名付きパッケージ](https://nsh.dev/translations/ja/docs/signed-packages.md)も読み込み、ビューごとに制限とケイパビリティを設定します([サンドボックスとケイパビリティ](https://nsh.dev/translations/ja/docs/sandbox-and-capabilities.md))。 ## すべてのプラットフォーム向けの書き方 アプリの大部分はプラットフォームのチェックを必要としません。要素、スタイル、レイアウト、モジュールはどこでも同じように動作します。プラットフォームごとに違いがある部分については、NSH がその違いを 1 か所にまとめています([プラットフォーム固有のコード](https://nsh.dev/translations/ja/docs/platform-specific.md))。 - **環境がアプリの実行場所を示します**。Rust では `os()`、`idiom()`、`is_desktop()`(`nsh_core::prelude`)、TSX では `nsh` から `platform.os`、`platform.idiom`、`platform.desktop`、`platform.select` を使います。OS は iOS、Android、macOS、Windows、Linux、Web のいずれかです。 - **プラットフォーム専用の props** は、TSX では `ios={{…}}`、`android={{…}}`、`web={{…}}`、`desktop={{…}}` に記述します(`desktop`: macOS、Windows、Linux、デスクトップブラウザー)。 - **入力はプラットフォームに従います**。スマートフォンではタッチとソフトウェアキーボード、デスクトップではマウス、トラックパッド、キーボードを使います。 アプリのコンポーネントは NSH のプリミティブで描画されるため、スマートフォンでもデスクトップでも動作し、どちらでも同じ見た目になります。デスクトップ向けレイアウトは、プリミティブ(`view`、`text`、`scroll`、`virtual_list` など。TSX では `View`、`Text`、`Scroll`、`List` など)とデスクトップかどうかのチェックで構築します。ギャラリーのデスクトップレイアウトがその例です。 ```rust use nsh_core::prelude::*; #[component] pub fn Shell() -> impl IntoElement { // macOS, Windows, Linux and desktop browsers get a sidebar; phones get tabs. view() .flex_1() .child(if is_desktop() { sidebar_layout() } else { tab_layout() }) } fn sidebar_layout() -> AnyElement { view().flex_1().flex_row().into_element() } fn tab_layout() -> AnyElement { view().flex_1().flex_col().into_element() } ``` ```tsx import { View } from "nsh"; import { platform } from "nsh"; export function Shell() { // macOS, Windows, Linux and desktop browsers get a sidebar; phones get tabs. return {platform.desktop ? : }; } function SidebarLayout() { return ; } function TabLayout() { return ; } ``` 各バックエンドが独自の方法で行う処理は、[macOS](https://nsh.dev/translations/ja/docs/macos.md#what-differs-on-macos)、[Windows](https://nsh.dev/translations/ja/docs/windows.md#what-differs-on-windows)、[Linux](https://nsh.dev/translations/ja/docs/linux.md#what-differs-on-linux)、[GPUI](https://nsh.dev/translations/ja/docs/gpui.md#differences) にまとめられています。 ## 関連項目 - [はじめに](https://nsh.dev/translations/ja/docs/getting-started.md): 最初のアプリを各プラットフォームで実行します。 - [Rust でのビルド](https://nsh.dev/translations/ja/docs/rust.md): Rust で書くアプリと、Rust と TSX の組み合わせ。 - [インストール](https://nsh.dev/translations/ja/docs/installation.md): 各プラットフォームで必要なツール。 - [アーキテクチャ](https://nsh.dev/translations/ja/docs/architecture.md): 何が共通で、各バックエンドが何を行うか。