Coheremote

アプリ概要

Coheremoteは、VMware Fusion上で動作するWindowsアプリケーションを、macOSのネイティブアプリのようにDockに統合するラッパーアプリ生成ツールです。 RemoteApp（RDP）技術を使用して、シームレスな操作体験を提供します。

こちらのXのポストからインスピレーションを受けました。

前提条件

使い方

ラッパーアプリの生成

1. Coheremoteを起動
2. 設定を入力
   • アプリケーション名: 生成するラッパーアプリの名前
   • 保存先: 生成した .app の保存場所
   • アイコン画像（オプション）: PNG、JPG、ICO、ICNS ファイル
   • VMパス: .vmx ファイルまたは .vmwarevm バンドル
   • VM暗号化パスワード（オプション）: 暗号化VMの場合
   • RDPファイル: RemoteApp用の .rdp ファイル
   • Windowsユーザー名: ログイン用
   • Windowsパスワード（オプション）: アプリランチャーのアプリ一覧取得に使用（VMware Toolsが必要）
3. オプション設定
   • RemoteApp変換（デフォルト: OFF）: RDPファイルにRemoteApp設定を自動注入。RemoteApp Toolを使わずに、通常のRDP接続を個別アプリのRemoteApp接続に変換できる
   • アプリ終了時にVMをサスペンド（デフォルト: ON）
   • アプリ終了時にWindowsをシャットダウン（デフォルト: OFF）
   • メニューバーにアプリランチャーを追加（デフォルト: ON）
   • Coheremoteバッジをアイコンに追加（デフォルト: OFF）
4. アプリをビルド をクリック
5. 生成されたアプリにフルディスクアクセスを付与

Dockメニュー（右クリック）

ラッパーアプリのDockアイコンを右クリックすると以下が表示されます（日英自動切替）:

アプリランチャー

メニューバーのアイコンをクリックすると、ランチャーパネルが表示されます:

• ヘッダー: アプリ名と接続ステータス（緑: 接続中 / グレー: 未接続）
• アプリ一覧: Windows側にインストールされたアプリケーションの一覧（クリックで起動）
• フッターボタン:
  • 再接続: RDP接続を再確立
  • 電源: 再起動・サスペンド・シャットダウン・アプリだけ終了
  • 表示/非表示: アプリ一覧の表示/非表示を編集（目のアイコン）
  • 更新: アプリ一覧を再取得
  • 終了: アプリを終了

注意: アプリランチャーのアプリ一覧を利用するには、Coheremoteの設定でWindowsパスワードを入力し、Windows側にVMware Toolsがインストールされている必要があります。

仕組み

ビルドプロセス

Coheremoteは以下の手順でスタンドアロンの .app バンドルを生成します:

1. RDPファイルにユーザー名を注入（BOM・改行コードを保持）
2. カスタムアイコンを sips + iconutil でmacOS .icns 形式に変換（Retina対応）
3. VM暗号化パスワードをmacOSキーチェーンに保存
4. Swiftソーステンプレートにパラメータを埋め込み、swiftc でネイティブバイナリをコンパイル
5. 標準的な .app バンドル構造にパッケージング

生成されるアプリの構造

MyApp.app/
  Contents/
    Info.plist
    MacOS/
      MyApp          # コンパイル済みSwiftバイナリ
    Resources/
      AppIcon.icns   # アプリアイコン
      app.rdp        # 修正済みRDPファイル

生成されるアプリの動作

1. VMware Fusionの起動確認 - 未起動なら自動起動
2. VMの起動/再開 - open -a "VMware Fusion" でVMを起動（コールドブート・サスペンド解除・暗号化VMすべてに対応）
3. VM状態のポーリング - 1秒間隔で起動完了を確認（タイムアウト: 120秒）
4. RDP接続 - Windows App（またはMicrosoft Remote Desktop）で接続
5. Dockに常駐 - VMライフサイクルを継続管理
6. 終了時処理 - 設定に応じてサスペンドまたはシャットダウン
7. ログ記録 - すべての操作を ~/Library/Logs/Coheremote/ に記録

RDPファイルの作成方法

方法1: RemoteApp Tool（推奨）

個別のWindowsアプリケーションをRemoteAppとして公開する方法です。

1. Windows側で RemoteApp Tool をダウンロード・実行
2. + をクリックしてアプリケーションを追加（例: notepad.exe）
3. アプリケーションを選択し、Create Client Connection をクリック
4. .rdp ファイルを保存
5. この .rdp ファイルをmac側にコピーし、Coheremoteで使用

方法2: Windows Appからのエクスポート

macOS側のWindows App（旧Microsoft Remote Desktop）から既存の接続設定をエクスポートする方法です。

1. Windows App を起動
2. 接続先のPCを追加（まだ追加していない場合）: + > PCの追加 をクリックし、PC名（VMのIPアドレスまたはホスト名）を入力して保存
3. 追加したPCを右クリック > RDPファイルにエクスポート を選択
4. .rdp ファイルを保存
5. この .rdp ファイルをCoheremoteで使用

注意: Windows Appからエクスポートした場合はフルデスクトップ接続になります。個別アプリのRemoteApp接続にするには、方法3（Coheremoteの変換機能）を使うか、.rdp ファイルをテキストエディタで開いて以下の行を追加してください:

remoteapplicationmode:i:1
remoteapplicationname:s:アプリ名
remoteapplicationprogram:s:アプリのパス

例（メモ帳の場合）:

remoteapplicationmode:i:1
remoteapplicationname:s:Notepad
remoteapplicationprogram:s:C:\Windows\System32\notepad.exe

方法3: CoheremoteのRemoteApp変換機能

Coheremoteの設定画面で直接RemoteApp変換を行う方法です。RDPファイルの手動編集が不要になります。

1. 方法2で .rdp ファイルを作成
2. Coheremoteの設定で RemoteApp変換 をONにする
3. アプリ名（表示名）と プログラムパス（Windows側の実行ファイルパス）を入力
4. ビルド時にRDPファイルへRemoteApp設定が自動注入されます

セキュリティに関する注意

• パスワード保存: VM暗号化パスワードとWindowsパスワードはmacOSキーチェーンに保存されます（UserDefaultsには保存されません）
• vmrunの制約: VMware Fusionの vmrun コマンドはパスワードをプロセス引数（-vp, -gp）でのみ受け付けます。これにより、同一ユーザーの他プロセスから ps コマンドでパスワードが閲覧可能です。これは vmrun の既知の制約であり、共有環境での使用時はご注意ください
• アプリ名サニタイズ: ビルド時にアプリ名からファイルシステム上の危険な文字（/, \, :, *, ?, ", <, >, |）が自動除去されます

トラブルシューティング