Index: chrome/common/extensions/docs/static/external_extensions.html |
=================================================================== |
--- chrome/common/extensions/docs/static/external_extensions.html (revision 133542) |
+++ chrome/common/extensions/docs/static/external_extensions.html (working copy) |
@@ -25,17 +25,18 @@ |
<p> |
An extension that's installed automatically is known as an |
<em>external extension</em>. |
-Google Chrome supports two ways of |
+Google Chrome supports three ways of |
installing external extensions: |
</p> |
<ul> |
<li> Using a preferences JSON file </li> |
<li> Using the Windows registry (Windows only) </li> |
+ <li> Using per-extension preference files (Linux only) </li> |
</ul> |
<p> |
-Both ways support installing an extension from a <code>.crx</code> extension |
+Each method supports installing an extension from a <code>.crx</code> extension |
file on the user's computer. The preferences JSON file also supports installing |
an extension hosted at an |
<a href="autoupdate.html#H2-1">update URL</a>. |
@@ -220,6 +221,41 @@ |
see the extension listed. </li> |
</ol> |
+<h2 id="per-extension-install">Using per-extension preference files (Linux only)</h2> |
+ |
+<ol> |
+<li>Make the <code>.crx</code> extension file available |
+to the machine you want to install the extension on. |
+</li> |
+<li>Find or create the folder: |
+<ul> |
+ <li> For a Google Chrome build: <code>/usr/share/google-chrome/extensions</code> </li> |
+ <li> For a Chromium build: <code>/usr/share/chromium/extensions</code> </li> |
+</ul> |
+</li> |
+<li>Create a file under this folder with the following name: |
+ <code>aaaaaaaaaabbbbbbbbbbcccccccccc.json</code> where the file name (without the extension) |
+corresponds to your extension's ID. |
+</li> |
+<li>In the file created during step 4) above, specify the extension's |
+associated <code>.crx</code> complete path along with the |
+version your extension: |
+<p> |
+Example: |
+<pre> |
+ { |
+ "external_crx": "/home/share/extension.crx", |
+ "external_version": "1.0" |
+ } |
+</pre> |
+</p> |
+</li> |
+<li> |
+Launch the browser and go to <b>chrome://extensions</b>; you |
+should see the extension listed with the proper version number. |
+</li> |
+</ol> |
+ |
<h2 id="updating">Updating and uninstalling</h2> |
<p>Google Chrome scans the metadata entries |
@@ -293,6 +329,22 @@ |
<br> |
+<p><b>What are some common mistakes when installing with the per-extension file?</b> </p> |
+<ul> |
+ <li>Not specifying the same id/version |
+ as the one listed in the <code>.crx</code> </li> |
+ <li>Extension preference file created in the wrong location or with the wrong extension ID name </li> |
+ <li>Extension entry points to the wrong path to the <code>.crx</code> file |
+ (or path specified but no filename) </li> |
+ <li>Permissions problems on a network share </li> |
+ <li> |
+ Syntax error in JSON file |
+ (forgetting to separate entries with comma or |
+ leaving a trailing comma somewhere) </li> |
+</ul> |
+ |
+<br> |
+ |
<p><b>What if the user uninstalls the extension?</b> </p> |
<p>If the user uninstalls the extension through the UI, it will no |
longer be installed or updated on each startup. In other words, the |