設定

IDE の設定

`product.json`

IDE の製品識別情報を、プロジェクトのルートに置きます。

json

{
  "productName": "MiniDev Studio",
  "applicationName": "minidev-studio",
  "dataFolderName": ".minidev-studio",
  "version": "1.3.6",
  "urlProtocol": "minidev-studio",
  "darwinBundleIdentifier": "com.woodare.minidev-studio"
}

環境変数

.env ファイル（.env.sample を参考）で開発環境を設定します。

変数名	説明	既定値
`IDE_SERVER_PORT`	Node サーバーのポート	自動割り当て
`WS_PATH`	WebSocket パス	既定のパス
`OPENSUMI_DEVTOOLS`	IDE DevTools の有効化	`false`

bash

# .env
OPENSUMI_DEVTOOLS=true
IDE_SERVER_PORT=8080

コンパイラの設定

シミュレーターは Vite でビルドします。app.json の framework に応じて挙動が切り替わります。

framework	コンパイラの挙動
`vue`	Vue 3 用プラグイン。`.vue` ページを解決
`react`	React 用プラグイン。`.tsx` / `.jsx` ページを解決

Vite プラグイン: `vite-plugin-minidev`

IDE 同梱の Vite プラグインの役割は次のとおりです。

Shell HTML の注入 — NavBar / TabBar / StatusBar を含むコンテナページを生成
rpx → vw 変換 — CSS 内の rpx を vw に変換
ブリッジ API の注入 — preload スクリプトで window.__MINIDEV__ を注入

rpx 単位

rpx（responsive pixel）はミニプログラム用のレスポンシブ単位で、1rpx ＝画面幅 ÷ 750 です。コンパイラが vw に変換し、シミュレーターで正しく表示できます。

よく使うコマンド

bash

# IDE 開発
yarn                     # 依存のインストール
yarn rebuild-native      # ネイティブモジュールの再ビルド
yarn download-extension  # VS Code 拡張の取得

# 起動
yarn start               # 完全ビルドのあと起動
yarn start:dev           # 差分ビルド + ウォッチ（推奨）
yarn start:quick         # ビルドを省略して起動（事前に out/ があること）

# デバッグ
OPENSUMI_DEVTOOLS=true yarn start  # DevTools を開く

# パッケージ
yarn make                # インストーラーの生成

設定 ​

IDE の設定 ​

product.json ​

環境変数 ​

コンパイラの設定 ​

Vite プラグイン: vite-plugin-minidev ​