その他の拡張機能の配信方法

警告: この記事は、非推奨の Manifest V2 バージョンを表示しています。MV3 の同等の機能については、Manifest V3 - 拡張機能の代替インストール方法をご覧ください。 Chrome ウェブストアでは、Manifest V2 拡張機能のサポートを終了しました。Manifest V3 への移行ガイドに沿って拡張機能を Manifest V3 に変換してください。

すべての Chrome 拡張機能は、Chrome ウェブストアから直接配布するか、 以下に説明するメカニズムがあります。これらの配布方法のいずれかを遵守しない場合は、 Chrome 拡張機能のポリシーに違反しているため、該当の拡張機能やソフトウェア 望ましくないソフトウェアとして報告されるように配布する行為。

通常、ユーザーは Chrome ウェブストアから拡張機能をインストールしますが、 他の方法でインストールできます。一般的なケースは次の 2 つです。

• 拡張機能が他のソフトウェアに関連付けられているため、拡張機能をインストールする必要があります ユーザーがそのソフトウェアをインストールしたときに 発生します
• ネットワーク管理者が、組織全体に同じ拡張機能をインストールしたいと考えています。

Chrome ウェブストアからインストールされていない拡張機能を外部拡張機能と呼びます。 他の Google Workspace ツールのインストール プロセスの一環として拡張機能を配布するデベロッパー向け 組織全体に拡張機能を配布したいネットワーク管理者には、 Google Chrome では、次の拡張機能のインストール方法をサポートしています。

• 環境設定の JSON ファイルを使用する（Mac OS X と Linux のみ）
• Windows レジストリを使用する（Windows のみ）

どちらの方法でも、update_URL でホストされている拡張機能をインストールできます。Windows と Mac の場合、 update_URL は、拡張機能がホストされている Chrome ウェブストアを指定する必要があります。

Linux 上の環境設定ファイルでは、拡張機能をホストしている独自のサーバーを指定できます。 設定 JSON ファイルでは、.crx 拡張ファイルからの拡張機能のインストールも インストールできます。

始める前に

まず、Chrome ウェブストアで拡張機能を公開するか、.crx ファイルをパッケージ化して、 正常にインストールされていることを確認します。

警告: Windows と Mac へのインストールは、Chrome ウェブストアから行う必要があります。 Chrome 33 では、Windows 上のローカル .crx へのパスから外部インストールすることはできません（ Windows ユーザーを悪意のある拡張機能から保護するをご覧ください）。Chrome 44 以降、外部インストールは ローカルの .crx へのパスから Mac に保存できます（悪意のある拡張機能から Chrome ユーザーを引き続き保護するをご覧ください）。

更新 URL からインストールする場合は、拡張機能が適切にホストされていることを確認してください。

環境設定ファイルまたはレジストリを編集する前に、次の情報をメモしてください。

• 拡張機能の .crx ファイルの目的の場所、またはファイルの更新元 URL 提供済み
• 拡張機能のバージョン（マニフェスト ファイルまたは chrome://extensions ページから取得）
• 拡張機能の ID（パックされたファイルを読み込んだときに chrome://extensions ページから取得されたもの） 拡張機能）

次の例では、バージョンが 1.0、ID が aaaaaaaaaabbbbbbbbbbcccccccccc であることを前提としています。

環境設定ファイルを使用する

注: Mac OS X と Linux のみ: Windows では環境設定ファイルを使用しないでください。Windows レジストリを使用する をご覧ください。

1. Linux 上のファイルからインストールする場合は、.crx 拡張機能ファイルを 拡張機能をインストールする マシンを選択します（ローカル ディレクトリまたはネットワークに 共有（例: \\server\share\extension.crx、/home/share/extension.crx）。

2. 以下のフォルダのいずれかに、次の名前のファイルを作成します。 aaaaaaaaaabbbbbbbbbbcccccccccc.json: ファイル名（拡張子なし）は、 拡張機能の ID です。場所はオペレーティング システムによって異なります。

   Mac OS X:

   特定のユーザーについて: ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/ すべてのユーザー: /Library/Application Support/Google/Chrome/External Extensions/

   パス内のすべてのディレクトリがオーナーになっている場合にのみ、すべてのユーザーの外部拡張機能ファイルが読み取られる ユーザー root で、グループ admin または wheel があり、全世界で書き込み可能ではありません。パスは シンボリックリンクも不要ですこの制限により、権限のないユーザーが 拡張機能をインストールするよう指示します。詳しくは、トラブルシューティングをご覧ください。

   注: すべてのユーザーを対象とする上記のパスは、Chrome 16 で追加されました。以前のバージョンでは、 path: /Applications/Google Chrome.app/Contents/Extensions/このパスはバージョン 17 で非推奨になりました。 バージョン 20 でサポートが削除されました。代わりに、上記のいずれかのパスを使用してください。

   Linux:

   /opt/google/chrome/extensions/

   /usr/share/google-chrome/extensions/

   注: 必要に応じて chmod を使用して、aaaaaaaaaabbbbbbbbbbcccccccccc.json 誰でも読み取ることができます。

3. Linux のみ: ファイルからインストールする場合は、拡張機能の場所とバージョンを 「external_crx」という「external_version」先ほど作成したファイルに記述します

   • 例:
   • json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
   • 注: 各 \` character in the location. For example,\server\share\extension.crxwould be"\\server\share\extension.crx"` は、それぞれエスケープする必要があります。
   • 更新 URL からインストールする場合は、拡張機能の更新 URL をフィールド名で指定します。 「external_update_url」。
   • ローカルの .crx ファイルからのインストール例（Linux のみ）:
   • json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
   • Chrome ウェブストアからのインストール例（Mac、Linux）:
   • json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
   • 一部のブラウザ ロケールのみに拡張機能をインストールする場合は、サポートされている "supported_locale" というフィールド名に指定する必要があります。言語 / 地域では、「en」などの親言語 / 地域を指定できます。 「en-US」や「en-GB」など、すべての英語の言語 / 地域に拡張機能がインストールされます。 拡張機能でサポートされていない別の言語 / 地域が選択されている場合、外部 拡張機能がアンインストールされます。"supported_locales" の場合:拡張子がない場合は、 インストールできます。
   • 例:
   • json { "external_update_url": "https://clients2.google.com/service/update2/crx", "supported_locales": [ "en", "fr", "de" ] }

4. JSON ファイルを保存します。

5. Google Chrome を起動し、chrome://extensions に移動します。拡張機能が表示されているはずです。

で確認できます。

注: 以前のバージョンの Google Chrome では、external_extensions.json ファイルを使用して インストールする拡張機能を指定できますこのファイルはサポートが終了し、個々の .json ファイル（ （拡張機能あたり）

Mac OS の権限に関する問題のトラブルシューティング

Mac OS では、ファイル システム権限がある場合にのみ、すべてのユーザーの外部拡張機能ファイルが読み取られます。 権限のないユーザーが設定を変更できないようにします。インストール時に外部拡張機能がインストールされていない場合 Chrome がリリースされました。外部の拡張機能の設定に権限の問題がある可能性があります できます。これが原因であるかどうかを確認するには、次の手順を行います。

1. コンソール プログラムを起動します。/Applications/Utilities/Console の下にあります。
2. コンソールの左端のアイコンに「Show Log List」と表示されている場合は、そのアイコンをクリックします。2 列目 が左側に表示されます。
3. [Console Messages（コンソール メッセージ）] をクリックしますをクリックします。
4. 「Can not read external extensions」という文字列を検索します。読み取りに問題がある場合は、 外部の拡張機能ファイルを使用すると、エラー メッセージが表示されます。別のエラー メッセージを探す 問題の説明が表示されますたとえば、次のエラーが表示されたとします。 「Path /Library/Application Support/Google/Chrome is ownership by the wrong group」と表示される場合は、 chgrp または Finder の [情報を見る] ダイアログで、ディレクトリのグループ オーナーを 管理者グループです。
5. 問題が解決したら、Chrome を再起動します。外部拡張機能がインストールされたことを確認します。これは、 1 つの権限エラーで、Chrome で 2 つ目のエラーが検出されないことがあります。もし 外部拡張機能がインストールされていませんでした。 できます。

Windows レジストリの使用

1. レジストリで次のキーを検索または作成します。 <ph type="x-smartling-placeholder">
   </ph>
   • 32 ビット Windows: HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
   • 64 ビット Windows: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
2. Extensions キーの下に、プロジェクトの ID と同じ名前で新しいキー（フォルダ）を作成します。 拡張子（例: aaaaaaaaaabbbbbbbbbbcccccccccc）。

3. 拡張機能キーでプロパティ「update_url」を作成し、次の値に設定します。 &quot;https://clients2.google.com/service/update2/crx&quot;（これは、拡張機能の crx を Chrome ウェブストア）:

   {
     "update_url": "https://clients2.google.com/service/update2/crx"
   }
   

4. ブラウザを起動し、chrome://extensions に移動します。拡張機能が表示されているはずです。

アップデートとアンインストール

Google Chrome では、ブラウザが毎回設定とレジストリのメタデータ エントリをスキャンします。 開始され、インストールされている外部拡張機能に必要な変更が行われます。

拡張機能を新しいバージョンに更新するには、ファイルを更新してから 環境設定やレジストリなどです

拡張機能をアンインストールする場合（ソフトウェアがアンインストールされた場合など）は、設定を削除します ファイル（aaaaaaaaabbbbbbbbcccccccccc.json）またはレジストリのメタデータ。

よくある質問

このセクションでは、外部拡張機能に関するよくある質問に回答します。

「プリインストール」を可能にする方法は、M33 以降は Google Chrome で引き続きサポートされます。 今後どうなるでしょうか？

はい。ただし、ローカル ファイルパスからではなく、Chrome ウェブストアの update_URL からのインストールとしてのみインストールできます。

外部拡張機能へのパスとして URL を指定できますか？

はい。Mac OS X と Linux では preferences JSON ファイルを使用します。Windows のレジストリで確認できます。「 ホスティングの説明に沿って拡張機能をホストする必要があります。環境設定ファイルでは、 「external_update_url」プロパティを、アプリケーションの URL を含む更新マニフェストを指す あります。Windows レジストリで、"update_url"プロパティです。

環境設定ファイルを使用してインストールするときによくある間違いは何ですか？

• .crx にリストされている ID / バージョンと同じ ID / バージョンを指定していない
• .json ファイル（aaaaaaaaaabbbbbbbbbbcccccccccc.json）の場所または ID が正しくありません 拡張機能 ID と一致していません。
• JSON ファイルの構文エラー（カンマでエントリを区切るのを忘れる、または末尾にカンマが残っている） 場所）
• JSON ファイルのエントリが、.crx への誤ったパス（またはパスは指定されているがファイル名がない）を指している
• UNC パス内のバックスラッシュがエスケープされない（たとえば、"\\server\share\file" は間違っています。適切にエスケープする必要があります） "\\\\server\\share\\extension")
• ネットワーク共有での権限の問題

レジストリを使用してインストールするときによくあるミスは何ですか？

• Chrome ウェブストアに掲載されている ID/バージョンと同じ ID またはバージョンを指定していない
• レジストリの間違った場所にキーが作成された
• レジストリ エントリが Chrome ウェブストアの .crx ファイルへの間違ったパスを参照している
• ネットワーク共有での権限の問題

ネイティブ バイナリと拡張機能を段階的に更新するにはどうすればよいですか？

以前はストア外の拡張機能がサポートされていたため、ネイティブ バイナリと 拡張機能はロックステップで更新されますただし、Chrome ウェブストアでホストされている拡張機能は デベロッパーが管理していない Chrome の更新メカニズムによって更新されることです。拡張機能のデベロッパーは ネイティブ バイナリと依存関係がある拡張機能の更新には注意が必要です（例: NPAPI を使用する従来の拡張機能）。

ユーザーが拡張機能をアンインストールするとどうなりますか？

ユーザーが UI から拡張機能をアンインストールすると、 できます。つまり、この外部拡張機能は拒否リストに登録されています。

ブロックリストから除外するにはどうすればよいですか？

ユーザーが拡張機能をアンインストールした場合は、その決定を尊重する必要があります。ただし、 UI から拡張機能を誤ってアンインストールしてしまった場合は、拒否リストタグを削除できます。 UI から通常どおり拡張機能をインストールし、その後アンインストールします。