| OLD | NEW |
| 1 <div id="pageData-name" class="pageData">Packaging</div> | 1 <div id="pageData-name" class="pageData">Packaging</div> |
| 2 <div id="pageData-showTOC" class="pageData">true</div> | 2 <div id="pageData-showTOC" class="pageData">true</div> |
| 3 | 3 |
| 4 <p> | 4 <p> |
| 5 This page describes how to package your extension. | 5 This page describes how to package your extension. |
| 6 As the <a href="overview.html">Overview</a> explains, | 6 As the <a href="overview.html">Overview</a> explains, |
| 7 extensions are packaged as signed ZIP files | 7 extensions are packaged as signed ZIP files |
| 8 with the file extension "crx" — | 8 with the file extension "crx"—for example, |
| 9 for example, <code>myextension.crx</code>. | 9 <code>myextension.crx</code>. |
| 10 </p> | 10 </p> |
| 11 | 11 |
| 12 <p> | 12 <p> |
| 13 <b>Note:</b> | 13 <b>Note:</b> |
| 14 You might not need to package your extension. | 14 You might not need to package your extension. |
| 15 If you publish your extension using the | 15 If you publish your extension using the |
| 16 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Develope
r Dashboard</a>, | 16 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Develope
r Dashboard</a>, |
| 17 then the only reason to create your own <code>.crx</code> file | 17 then the only reason to create your own <code>.crx</code> file |
| 18 would be to distribute a non-public version — | 18 would be to distribute a non-public version—for example, |
| 19 for example, to alpha testers. | 19 to alpha testers. |
| 20 You can find information on publishing extensions and apps in the |
| 21 Chrome Web Store getting started tutorial, starting at |
| 22 <a href="http://code.google.com/chrome/webstore/docs/get_started_simple.html#ste
p5">Step 5: Zip up your app</a>. |
| 20 </p> | 23 </p> |
| 21 | 24 |
| 22 <!-- [PENDING: Refer to instructions on submitting an extension for inclusion in
the gallery.] --> | |
| 23 | |
| 24 <p> | 25 <p> |
| 25 When you package an extension, | 26 When you package an extension, |
| 26 the extension is assigned a unique key pair. | 27 the extension is assigned a unique key pair. |
| 27 The extension's ID is based on a hash of the public key. | 28 The extension's ID is based on a hash of the public key. |
| 28 The private key is kept private | 29 The private key is kept private |
| 29 and used to sign each version of the extension. | 30 and used to sign each version of the extension. |
| 30 </p> | 31 </p> |
| 31 | 32 |
| 32 | 33 |
| 33 <h2>Creating a package</h2> | 34 <h2>Creating a package</h2> |
| (...skipping 13 matching lines...) Expand all Loading... |
| 47 click the +. | 48 click the +. |
| 48 </li> | 49 </li> |
| 49 | 50 |
| 50 <li> | 51 <li> |
| 51 Click the <b>Pack extension</b> button. | 52 Click the <b>Pack extension</b> button. |
| 52 A dialog appears. | 53 A dialog appears. |
| 53 </li> | 54 </li> |
| 54 | 55 |
| 55 <li> | 56 <li> |
| 56 In the <b>Extension root directory</b> field, | 57 In the <b>Extension root directory</b> field, |
| 57 specify the path to the extension's folder — | 58 specify the path to the extension's folder—for example, |
| 58 for example, <code>c:\myext</code>. | 59 <code>c:\myext</code>. |
| 59 (Ignore the other field; | 60 (Ignore the other field; |
| 60 you don't specify a private key file | 61 you don't specify a private key file |
| 61 the first time you package a particular extension.) | 62 the first time you package a particular extension.) |
| 62 </li> | 63 </li> |
| 63 | 64 |
| 64 <li> | 65 <li> |
| 65 Click <b>OK</b>. | 66 Click <b>OK</b>. |
| 66 The packager creates two files: | 67 The packager creates two files: |
| 67 a <code>.crx</code> file, | 68 a <code>.crx</code> file, |
| 68 which is the actual extension that can be installed, | 69 which is the actual extension that can be installed, |
| (...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 106 by going to this URL: <b>chrome://extensions</b> | 107 by going to this URL: <b>chrome://extensions</b> |
| 107 </li> | 108 </li> |
| 108 | 109 |
| 109 <li> | 110 <li> |
| 110 Click the <b>Pack extension</b> button. | 111 Click the <b>Pack extension</b> button. |
| 111 A dialog appears. | 112 A dialog appears. |
| 112 </li> | 113 </li> |
| 113 | 114 |
| 114 <li> | 115 <li> |
| 115 In the <b>Extension root directory</b> field, | 116 In the <b>Extension root directory</b> field, |
| 116 specify the path to the extension's folder — | 117 specify the path to the extension's folder—for example, |
| 117 for example, <code>c:\myext</code>. | 118 <code>c:\myext</code>. |
| 118 </li> | 119 </li> |
| 119 | 120 |
| 120 <li> | 121 <li> |
| 121 In the <b>Private key file</b> field, | 122 In the <b>Private key file</b> field, |
| 122 specify the location of the | 123 specify the location of the |
| 123 already generated <code>.pem</code> file for this extension — | 124 already generated <code>.pem</code> file for this extension—for |
| 124 for example, <code>c:\myext.pem</code>. | 125 example, <code>c:\myext.pem</code>. |
| 125 </li> | 126 </li> |
| 126 | 127 |
| 127 <li> | 128 <li> |
| 128 Click <b>OK</b>. | 129 Click <b>OK</b>. |
| 129 </li> | 130 </li> |
| 130 </ol> | 131 </ol> |
| 131 | 132 |
| 132 <p>If the updated extension is successfully packaged, you'll see a dialog like t
his:</p> | 133 <p>If the updated extension is successfully packaged, you'll see a dialog like t
his:</p> |
| 133 | 134 |
| 134 <img src="images/update-success.gif" | 135 <img src="images/update-success.gif" |
| (...skipping 18 matching lines...) Expand all Loading... |
| 153 <p> | 154 <p> |
| 154 To suppress the dialog, | 155 To suppress the dialog, |
| 155 add <code>--no-message-box</code> to the command. | 156 add <code>--no-message-box</code> to the command. |
| 156 </p> | 157 </p> |
| 157 | 158 |
| 158 <h2>Package format and scripts</h2> | 159 <h2>Package format and scripts</h2> |
| 159 <p> | 160 <p> |
| 160 For more information on the format, as well as pointers to scripts you can use | 161 For more information on the format, as well as pointers to scripts you can use |
| 161 to create <code>.crx</code> files, see <a href="crx.html">CRX Package Format</a>
. | 162 to create <code>.crx</code> files, see <a href="crx.html">CRX Package Format</a>
. |
| 162 </p> | 163 </p> |
| OLD | NEW |