diff options
author | Florian Merz <me@fiji-flo.de> | 2021-02-11 12:07:59 +0100 |
---|---|---|
committer | Florian Merz <me@fiji-flo.de> | 2021-02-11 12:07:59 +0100 |
commit | 6ef1fa4618e08426b874529619a66adbd3d1fcf0 (patch) | |
tree | 890e3e27131be010d82ef957fa68db495006cb0e /files/ja/orphaned/mozilla | |
parent | 8260a606c143e6b55a467edf017a56bdcd6cba7e (diff) | |
download | translated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.tar.gz translated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.tar.bz2 translated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.zip |
unslug ja: move
Diffstat (limited to 'files/ja/orphaned/mozilla')
3 files changed, 311 insertions, 0 deletions
diff --git a/files/ja/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html b/files/ja/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html new file mode 100644 index 0000000000..8b78f7bf11 --- /dev/null +++ b/files/ja/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html @@ -0,0 +1,68 @@ +--- +title: 拡張機能をパッケージ化する +slug: Mozilla/Add-ons/WebExtensions/Publishing_your_WebExtension +tags: + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/Package_your_extension_ +--- +<div>{{AddonSidebar}}</div> + +<p> </p> + +<div class="pull-aside"> +<div class="moreinfo"> +<p>Firefox ではパッケージされた拡張機能を "XPI ファイル" と呼び、これは単に色々な拡張機能を集めた ZIP ファイルです。</p> + +<p>AMO にアップロードする時に、XPI 拡張機能を使う必要はありません。</p> +</div> +</div> + +<p> </p> + +<p>開発期間中、拡張機能は manifest.json ファイルとその他の必要なファイル—スクリプト、アイコン、HTML 文書などを含む 1 つのディレクトリで構成されるでしょう。AMO にアップロードするにはこれを 1 つの zip ファイルにまとめる必要があります。</p> + +<p>web-ext を使っている場合、拡張機能をパッケージ化するのに <a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/web-ext_command_reference#web-ext_build">web-ext build </a>を使います。その他の場合、下記の OS ごとの手順に従ってください。</p> + +<div class="note"> +<p>Tip. ZIP ファイルは拡張機能を構成するファイル自身でなくてはならず、これらを含んだディレクトリであってはいけません。</p> +</div> + +<h3 id="Windows" name="Windows">Windows</h3> + +<ol> + <li>あなたの拡張機能を格納したフォルダを開きます。</li> + <li>すべてのファイルを選択します。</li> + <li>右クリックメニューの「送る」 から zip圧縮を選びます。</li> +</ol> + +<p><img alt="" src="https://mdn.mozillademos.org/files/11949/install-windows.png" style="display: block; height: 576px; margin-left: auto; margin-right: auto; width: 800px;"></p> + +<h3 id="Mac_OS_X" name="Mac_OS_X">Mac OS X</h3> + +<ol> + <li>あなたの拡張機能を格納したディレクトリを開きます。</li> + <li>すべてのファイルを選択します。</li> + <li>右クリックメニューから圧縮を選びます。</li> +</ol> + +<p><img alt="" src="https://mdn.mozillademos.org/files/11951/install-osx.png" style="display: block; height: 449px; margin-left: auto; margin-right: auto; width: 800px;"></p> + +<div class="pull-aside"> +<div class="moreinfo">コマンドについて <a href="http://www.info-zip.org/mans/zip.html">http://www.info-zip.org/mans/zip.html</a>.</div> +</div> + +<h3 id="Linux_Mac_OS_X_Terminal" name="Linux_Mac_OS_X_Terminal">Linux / Mac OS X ターミナル</h3> + +<ol> + <li>ターミナルを開きます。</li> + <li>拡張機能を含むディレクトリを開きます、そのコマンドは<br> + <code>cd path/to/<em>my-extension</em>/</code></li> + <li>ディレクトリの中身を ZIP します、そのコマンドは<br> + <code>zip -r -FS ../<em>my-extension</em>.zip *</code></li> +</ol> + +<p> </p> + +<p> </p> + +<p> </p> diff --git a/files/ja/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html b/files/ja/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html new file mode 100644 index 0000000000..3baef65043 --- /dev/null +++ b/files/ja/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html @@ -0,0 +1,24 @@ +--- +title: Google Chrome からの移行 +slug: Mozilla/Add-ons/WebExtensions/Porting_from_Google_Chrome +tags: + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/Porting_a_Google_Chrome_extension +--- +<div>{{AddonSidebar}}</div> + +<p>WebExtension API で開発する拡張機能は、ブラウザー間で互換性が維持されるように設計されており、大半は Google Chrome や Opera でサポートされている <a class="external external-icon" href="https://developer.chrome.com/extensions">extension API</a> とコード互換性があります。これらのブラウザー向けに書かれた拡張機能はほとんどの場合、少しの変更を加えるだけで Firefox でも動くようになります。ほぼすべての <a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API">WebExtension API</a> は、Chrome と同様に <code>chrome</code> 名前空間のコールバック関数を使ってサポートされています。<code>chrome</code> 名前空間でサポートされない唯一の API は、わざと Chrome と互換性がないものです。こうしたまれな場合は、API ドキュメントページでは明示的に、<code>browser</code> 名前空間だけでサポートされることを述べています。Chrome や Opera から拡張機能を移行する手順は下記の通り:</p> + +<ol> + <li>manifest.json の設定項目や使用している WebExtensionAPI が <a href="/ja/Add-ons/WebExtensions/Chrome_incompatibilities">Chrome との非互換性リファレンス</a>に載っているか確認します。もし Firefox でサポートされていない設定項目や API を利用している場合、まだ移行できないかもしれません。 Mozilla はこの手順を自動化するサービスを次にて提供しています: <a href="https://www.extensiontest.com/">https://www.extensiontest.com/</a>.</li> + <li><a href="/ja/Add-ons/WebExtensions/Packaging_and_installation">拡張機能を Firefox にインストールしてテストします</a>。</li> + <li>もし何か問題が見つかったら、 <a class="external external-icon" href="https://mail.mozilla.org/listinfo/dev-addons">dev-addons mailing list</a> または <a class="external external-icon" href="https://wiki.mozilla.org/IRC">IRC</a> の <a href="irc://irc.mozilla.org/webextensions">#webextensions</a> に連絡してください。</li> + <li><a href="/ja/Add-ons/Distribution">アドオンの署名と配布を行うため、アドオンを AMO に送ります</a>。</li> +</ol> + +<p><span id="result_box" lang="ja"><span>展開された拡張機能をロードするのに Chrome のコマンドラインオプションを使用していた場合、開発用に Firefox へ自動的に</span></span><span lang="ja"><span>仮インストールを行う</span></span> <a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Getting_started_with_web-ext">web-ext</a> <span lang="ja"><span>ツールを使用してみてください。</span></span> </p> + +<ul> +</ul> + +<div id="divLookup" style="background-color: transparent; color: #000000; position: absolute; top: 683px; left: 479px; padding: 0px; border-radius: 2px;"><img></div> diff --git a/files/ja/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html b/files/ja/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html new file mode 100644 index 0000000000..4afb4fe00e --- /dev/null +++ b/files/ja/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html @@ -0,0 +1,219 @@ +--- +title: パッケージ化とインストール +slug: Mozilla/Add-ons/WebExtensions/Packaging_and_installation +translation_of: Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox +translation_of_original: Mozilla/Add-ons/WebExtensions/Packaging_and_installation +--- +<div>{{AddonSidebar}}</div> + +<p>この記事では、WebExtension を Firefox にインストールする方法を 2 つ紹介します。</p> + +<ul> + <li><a href="/ja/Add-ons/WebExtensions/Packaging_and_installation#ディスクから読み込む">ディスクから読み込む</a>: アドオンの開発中にテストしたい場合に最も簡単な方法です。</li> + <li><a href="/ja/Add-ons/WebExtensions/Packaging_and_installation#パッケージ化してインストールする">パッケージ化してインストールする</a>: この方法を用いると、アドオンをインストール可能なファイルにパッケージ化し、Firefox へ永続的にインストールさせることができます。自分の作ったアドオンを他の人に配布する際はこの方法を用いることになります。また、リリース版の Firefox にインストールさせるには、アドオンに署名をすることも必要になります。</li> +</ul> + +<p>{{英語版章題("Loading from disk")}}</p> + +<h2 id="ディスクから読み込む">ディスクから読み込む</h2> + +<p>WebExtension を Firefox で動作させるには、この方法が最もシンプルです。また、<a href="/ja/Add-ons/Bootstrapped_extensions">ブートストラップ型拡張機能</a> や <a href="/ja/Add-ons/SDK">Add-on SDK を使ったアドオン</a> といった、再起動の要らないアドオンはすべてこの方法でインストールできます。</p> + +<p>ここでは Firefox 45 以降が必要となります。</p> + +<p>ディスクから読み込むには、</p> + +<ul> + <li>Firefox を起動し、</li> + <li>URL バーに "about:debugging" と入力し、</li> + <li>"一時的なアドオンを読み込む" をクリックし、</li> + <li>アドオンのディレクトリを開き、アドオン中のファイルを任意に選択します。</li> +</ul> + +<p>これでアドオンがインストールされ、Firefox を再起動するまで有効になります。</p> + +<p>{{EmbedYouTube("sAM78GU4P34")}}</p> + +<p>{{英語版章題("Updating a temporary add-on")}}</p> + +<h3 id="一時的なアドオンの更新">一時的なアドオンの更新</h3> + +<p>この方法でアドオンをインストールした場合、アドオンのファイルを更新すると何が起きるでしょうか?</p> + +<p>{{英語版章題("Before Firefox 48")}}</p> + +<h4 id="Firefox_47_以前">Firefox 47 以前</h4> + +<ul> + <li>オンデマンドに読み込まれるファイル(<a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">content scripts</a> や <a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">ポップアップ</a> など)を更新した場合、変更は自動的に取り込まれ、次に content scripts が読み込まれたりポップアップが表示された際に反映されます。</li> + <li>常に読み込まれているファイル(<a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">background scripts</a> など)を更新した場合、about:addons のページでアドオンを無効化・有効化すると変更が反映されます。</li> + <li><a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a> ファイルを更新した場合、Firefox を再起動してアドオンを再度読み込ませる必要があります。</li> +</ul> + +<div class="note"> +<p>Firefox 47 以前では、Firefox を再起動せずに「一時的なアドオンを読み込む」をクリックしても更新は<em>反映されない</em> ことに注意してください。</p> +</div> + +<p>{{英語版章題("Firefox 48 onwards")}}</p> + +<h4 id="Firefox_48_以降">Firefox 48 以降</h4> + +<ul> + <li>オンデマンドに読み込まれるファイル(<a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">content scripts</a> や <a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">ポップアップ</a> など)を更新した場合、変更は自動的に取り込まれ、次に content scripts が読み込まれたりポップアップが表示された際に反映されます。</li> + <li>他の場合に関しては利便性が向上しました。「デバッグ」ボタンの横にある「リロード」ボタンをクリックすることで、以下のことが可能となります。 + <ul> + <li>永続的なスクリプト(<a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">background scripts</a> など)のリロード</li> + <li>manifest.json ファイルが再度パースされ、<code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></code> / <code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code> / <code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a></code> などに対する変更の反映</li> + </ul> + </li> +</ul> + +<div class="note"> +<p>Firefox 48 のみに関する注意点として、about:debugging と about:addons に表示されるアドオンの名前と説明文は、「リロード」ボタンをクリックしても更新されません。この問題は Firefox 49 で修正されます。</p> +</div> + +<p>{{英語版章題("Package and install")}}</p> + +<h2 id="パッケージ化してインストールする">パッケージ化してインストールする</h2> + +<p>ディスクからの読込は 開発 / テスト / デバッグ のサイクルにおいては有効です。しかし、アドオンを他の人と共有したい場合は、アドオンを インストール可能な形式にパッケージ化する必要があります。</p> + +<p>{{英語版章題("Packaging")}}</p> + +<h3 id="パッケージ化">パッケージ化</h3> + +<p>Firefox のアドオンは XPI ファイルでパッケージ化されます。XPI ファイルとは単なる ZIP ファイルですが、ファイルの拡張子は ".xpi" となります。</p> + +<p>一つ注意しなければならないのは、アドオンのファイルを含んだディレクトリの ZIP ファイルではなく、アドオンのファイルを直接含んだ ZIP ファイルとする必要がある点です。</p> + +<h4 id="Windows">Windows</h4> + +<ol> + <li>アドオンのファイルが含まれているフォルダを開きます。</li> + <li>ファイルすべてを選択します。</li> + <li>右クリックして "送る" → "圧縮(zip 形式)フォルダー" を選択します。</li> + <li>作成されたファイルの名前を "something.zip" から "something.xpi" に変更します。</li> +</ol> + +<p><img alt="" src="https://mdn.mozillademos.org/files/11949/install-windows.png" style="display: block; height: 576px; margin-left: auto; margin-right: auto; width: 800px;"></p> + +<h4 id="Mac_OS_X">Mac OS X</h4> + +<ol> + <li>アドオンのファイルが含まれているフォルダを開きます。</li> + <li>ファイルすべてを選択します。</li> + <li>右クリックして "n 項目を圧縮" を選択します。</li> + <li>作成されたファイルの名前を <code>Archive.zip</code> から <code>something.xpi</code> に変更します。</li> +</ol> + +<p><img alt="" src="https://mdn.mozillademos.org/files/11951/install-osx.png" style="display: block; height: 449px; margin-left: auto; margin-right: auto; width: 800px;"></p> + +<h4 id="Linux_Mac_OS_X_Terminal">Linux / Mac OS X Terminal</h4> + +<ol> + <li><code>cd path/to/my-addon/</code></li> + <li><code>zip -r ../my-addon.xpi *</code></li> +</ol> + +<p>{{英語版章題("Installation")}}</p> + +<h3 id="インストール">インストール</h3> + +<p>XPI ファイルをインストールする前に、次のどちらかの手順を踏む必要があります。</p> + +<ul> + <li>XPI ファイルに署名する</li> + <li>未署名の XPI ファイルをインストール可能にする。ただし、この設定は Firefox Nightly か Firefox Developer Edition のみ可能であることに注意してください。自分のアドオンを一般に配布したい場合は署名が必要です。</li> +</ul> + +<p>{{英語版章題("Getting your add-on signed")}}</p> + +<h4 id="アドオンに署名する">アドオンに署名する</h4> + +<p>XPI ファイルに署名するには、<a href="/ja/docs/Mozilla/Add-ons/Distribution">Signing and distributing your Add-on</a> の記事を参照してください。</p> + +<p>{{英語版章題("Enabling unsigned add-ons")}}</p> + +<h4 id="未署名のアドオンを有効にする">未署名のアドオンを有効にする</h4> + +<p>未署名のアドオンを有効にするには、以下の手順に従ってください。</p> + +<ul> + <li><a href="https://www.mozilla.org/ja/firefox/developer/">Firefox Developer Edition</a> または <a class="external text external-icon" href="https://nightly.mozilla.org/" rel="nofollow">Firefox Nightly</a> をダウンロード、インストール、起動してください。</li> + <li>未署名アドオンのインストールを制御する Firefox の設定項目を変更します。この設定は Firefox Developer Edition と Firefox Nightly のみ可能です。 + <ul> + <li>Firefox の URL バーに <code>about:config</code> を入力します。</li> + <li>検索欄に <code>xpinstall.signatures.required</code> と入力します。</li> + <li>設定項目をダブルクリックするか、右クリックからの "切り替え" を選択し、値を <code>false</code> に変更します。</li> + </ul> + </li> +</ul> + +<p>{{EmbedYouTube("HgtBYDWtH4w")}}</p> + +<p>{{英語版章題("Installing an XPI in Firefox")}}</p> + +<h4 id="XPI_ファイルを_Firefox_にインストールする">XPI ファイルを Firefox にインストールする</h4> + +<p>XPI ファイルに署名した場合でも、署名の制約を無効化した場合でも、XPI ファイルをインストールする手順はどちらも同じです。</p> + +<ol> + <li><code>about:addons</code> に移動します。</li> + <li>XPI ファイルをページにドラッグ & ドロップするか、歯車アイコンのメニューを開いて "ファイルからアドオンをインストール" を選択します。</li> + <li>表示されたダイアログで "インストール" をクリックします。</li> +</ol> + +<p>他にも、"ファイル" → "開く" から XPI ファイルを選択したり、Control+O (Command+O) で選択することも可能です。</p> + +<p>{{英語版章題("Installing your extension of Firefox OS")}}</p> + +<h4 id="アドオンを_Firefox_OS_にインストールする">アドオンを Firefox OS にインストールする</h4> + +<p>USB か Wifi で接続されたデスクトップ PC で <a href="/ja/docs/Tools/WebIDE">WebIDE</a> を起動すれば、WebIDE からアドオンをインストールすることができます。WebIDE で "path/to/my-extension" をパッケージ型アプリとして開いてください。</p> + +<p>manifest.json の認証状況が正しければ、接続されたデバイス(Firefox OS の nightly ビルドで動作しているもの)にアドオンをインストールし、実行することができます。</p> + +<p>このアドオンの初回実行時は、Firefox OS のデバイスで Settings → Add-ons で有効にする必要があります。</p> + +<p>{{英語版章題("Troubleshooting")}}</p> + +<h3 id="トラブルシューティング">トラブルシューティング</h3> + +<p>起こりやすい問題には以下のようなものがあります。</p> + +<h4 id="This_add-on_could_not_be_installed_because_it_has_not_been_verified.">"This add-on could not be installed because it has not been verified."</h4> + +<ul> + <li>アドオンが署名されていないため、<a href="/ja/Add-ons/WebExtensions/Packaging_and_installation#未署名のアドオンを有効にする">未署名アドオンのインストールを有効にしているか</a> 確認してください。</li> +</ul> + +<h4 id="This_add-on_could_not_be_installed_because_it_appears_to_be_corrupt.">"This add-on could not be installed because it appears to be corrupt."</h4> + +<ul> + <li>アドオンのファイルを<em>含んだ</em> ディレクトリの ZIP ファイルではなく、アドオンのファイルを直接含んだ ZIP ファイルであるか確認してください。manifest.json は ZIP ファイルのルートに置かれていなければなりません。</li> + <li>manifest.json において <a href="/ja/Add-ons/WebExtensions/manifest.json/applications">applications</a> キーの値に "gecko" が設定されているか確認してください。</li> + <li>Firefox 44 以降を使用しているか確認してください。</li> + <li>コードや JSON ファイルにシンタックスエラーがないことを確認してください。</li> + <li><a href="/ja/docs/Tools/Browser_Console">ブラウザコンソール</a> に他の情報が表示されていないか確認してください。</li> +</ul> + +<p>{{英語版章題("Nothing happens")}}</p> + +<h4 id="何も起こらない">何も起こらない</h4> + +<ul> + <li>ファイル名の末尾が確かに <code>.xpi</code> であるか確認してください。OS によってはファイルの拡張子を<em>本当に</em> 隠したがるものがあります。 + + <ul> + <li>Windows の場合、 View → Show / Hide: File Name Extensions を確認してください。</li> + <li>Mac OS X の場合、 File → Get Info → Name and Extension を確認してください。</li> + </ul> + </li> + <li>インストール時のプロンプトでクリックを間違えたか、プロンプトを見失ってしまった可能性があります。Nightly の戻るボタン横にあるパズルピースのアイコンを探してください。そのアイコンをクリックするとポップアップが再度表示されます。</li> +</ul> + +<p>{{英語版章題("Check the console")}}</p> + +<h4 id="コンソールを確認する">コンソールを確認する</h4> + +<p>アドオンが解凍されたり読み込まれる過程に関して、他のエラーメッセージが <a href="/ja/docs/Tools/Browser_Console">ブラウザコンソール</a> に表示されている場合があります。</p> |