ウェブインストールとディープリンク
デスクトップで使うために、コマンドを手作業で作り直す必要はありません。Rephloのウェブギャラリー、ご自身のアカウント、または組織内でコマンドを見つけたら、ワンクリックでそれをデスクトップアプリに直接送ることができます。これはディープリンクという仕組みで実現しています。app.rephlo:// という特別なリンクを、ウェブページがインストール済みのアプリへ受け渡します。
このページでは、インストールリンクの仕組み、インストールプレビューに表示される内容、そしてRephloが複数のコマンドを一度にインストールする際の処理方法について説明します。
ウェブインストールの仕組み
ウェブページで Install をクリックすると、ブラウザが app.rephlo:// リンクを開きます。お使いのオペレーティングシステムは、このリンクがRephloに属することを認識し、デスクトップアプリへ受け渡します。その後Rephloがコマンドの詳細を取得し、プレビューを表示したうえで、確認したコマンドを追加します。
前提条件
ウェブインスト ールを成功させるには、以下が必要です。
- お使いのコンピューターにRephloデスクトップアプリがインストールされている必要があります。
app.rephlo://リンクハンドラーがオペレーティングシステムに登録されている必要があります。これは初回起動時にRephloが自動的に登録します(Windowsではユーザーごとのエントリが追加され、管理者権限は不要です)。- 自分専用または組織専用のコマンドの場合はサインインしている必要があります。公開ギャラリーのコマンドについてはログインは不要です。
インストールリンクの種類
Rephloは、コマンドの取得元に応じていくつかの種類のインストールリンクを認識します。
| リンクの種類 | 取得元 |
|---|---|
| Gallery install | ギャラリーからslugまたはIDで開かれる、単一の公開コマンド。 |
| Web install | IDで参照される、1つ以上の公開コマンド。 |
| My (private) install | 自分のアカウント専用のコマンド。 |
| Org install | 組織(ワークスペース)内で共有され、その組織に限定されるコマンド。 |
gallery インストールリンクは、単一のコマンド(1つのslugまたはID)をインストールします。web、private、org の各インストールリンクは一括インストールに対応しており、リンクにカンマ区切りのID一覧を含めることができ、Rephloが重複を自動的に取り除きます。
インストールプレビュー
アプリに何かが追加される前に、Rephloはインストールプレビューを表示し、あなたが内容をコントロールできるようにします。プレビューには、リンクに含まれるすべてのコマンドが以下の情報とともに一覧表示されます。
- name(名前)、group(グループ)、author(作成者)、language(言語)。
- このインストールに含めるか除外するかを選ぶチェックボックス。
- コマンドがすでにインストール済みの場合は、その旨を示すはっきりしたマークが表示されます。これらは誤って重複を作らないよう、あらかじめチェックが外された状態になっています。
プレビューからは、以下の操作ができます。
- 未インストールのコマンドをSelect all(すべて選択)またはdeselect all(すべて選択解除)する。
- 必要に応じてgroup override(グループの上書き)を選択し、受信するコマンドを元のグループではなく自分で選んだグループに配置する。
- Install ボタンで確定する。ボタンには選択中のコマンド数が表示されます。少な くとも1つのコマンドが選択されるまで、ボタンは無効のままです。
インストールプレビューダイアログ: 受信するコマンドのチェックリスト(名前、グループ、作成者、言語)、「already installed」(インストール済み)バッジ、Select All / Deselect Allの操作、任意のグループ上書き用ドロップダウン、選択件数が表示されたInstallボタン。
複数のコマンドを一度にインストールする(一括インストール)
リンクに複数のコマンドが含まれる場合、Rephloはチェックを入れたままにしたコマンドすべてを一度の処理でインストールします。この際、以下も行われます。
- 既に持っているコマンドにフラグを立てることで競合を検出し、スキップできるようにします。
- グループの解決または作成 — 受信したコマンドが、既存のグループ(名前で照合)に属している場合はそのグループに追加され、そうでない場合はRephloが新しいグループを作成します。グループの上書きを設定していた場合は、そちらが優先されます。
- combination形式のコマンドについては指示文をクリーンアップし、Rephlo標準の「そのまま使えるテキストのみを出力する」というガイダンスを追加することで、インストールされたコマンドの挙動を一貫させます。
インストールされたコマンドにはNewというマークが付き、ライブラリの中で見つけやすくなっており、すぐに編集・実行できます。
うまくいかない場合
- アプリが未インストール — リンクからRephloを開けません。まず rephlo.app/download からデスクトップアプリをインストールしてから、リンクをもう一度クリックしてください。
- サインインしていない — プライベートコマンドおよび組織のコマンドにはログインが必要です。サインインしてから再試行してください。詳しくは サインインと認証 を参照してください。
- リンクが無効または期限切れ — コマンドIDが見つからない場合、何もインストールされません。ウェブページからあらためて安全に再試行できます。
関連ページ
- クラウド同期とバージョン管理 — 自分のコマンドをクラウドに公開する。
- コマンドギャラリー — ウェブからコマンドを閲覧・インストールする。
- マイコマンド — アカウント内のコマンドを管理する。
- コマンドの管理 — インストール後にコマンドを編集・整理する。