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"—for example, | 8 with the file extension "crx"—for example, |
9 <code>myextension.crx</code>. | 9 <code>myextension.crx</code>. |
10 </p> | 10 </p> |
(...skipping 62 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
73 </ol> | 73 </ol> |
74 | 74 |
75 | 75 |
76 <p> | 76 <p> |
77 <b>Do not lose the private key!</b> | 77 <b>Do not lose the private key!</b> |
78 Keep the <code>.pem</code> file secret and in a safe place. | 78 Keep the <code>.pem</code> file secret and in a safe place. |
79 You'll need it later if you want to do any of the following: | 79 You'll need it later if you want to do any of the following: |
80 </p> | 80 </p> |
81 <ul> | 81 <ul> |
82 <li><a href="#update">Update</a> the extension</li> | 82 <li><a href="#update">Update</a> the extension</li> |
83 <li>Upload the extension using the | 83 <li><a href="#upload">Upload</a> the extension to the Chrome Web Store</li> |
84 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Develope
r Dashboard</a></li> | |
85 </ul> | 84 </ul> |
86 | 85 |
87 <p> | 86 <p> |
88 If the extension is successfully packaged, you'll see a dialog like this | 87 If the extension is successfully packaged, you'll see a dialog like this |
89 that tells you where to find | 88 that tells you where to find |
90 the <code>.crx</code> and <code>.pem</code> files:</p> | 89 the <code>.crx</code> and <code>.pem</code> files:</p> |
91 </p> | 90 </p> |
92 | 91 |
93 <img src="images/package-success.gif" | 92 <img src="images/package-success.gif" |
94 width="554" height="208" /> | 93 width="554" height="208" /> |
(...skipping 33 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
128 <li> | 127 <li> |
129 Click <b>OK</b>. | 128 Click <b>OK</b>. |
130 </li> | 129 </li> |
131 </ol> | 130 </ol> |
132 | 131 |
133 <p>If the updated extension is successfully packaged, you'll see a dialog like t
his:</p> | 132 <p>If the updated extension is successfully packaged, you'll see a dialog like t
his:</p> |
134 | 133 |
135 <img src="images/update-success.gif" | 134 <img src="images/update-success.gif" |
136 width="298" height="160" /> | 135 width="298" height="160" /> |
137 | 136 |
| 137 |
| 138 <h2 id="upload"> Uploading a previously packaged extension to the Chrome Web Sto
re</h2> |
| 139 |
| 140 <p> |
| 141 You can use the Chrome Developer Dashboard |
| 142 to upload an extension that you've previously packaged yourself. |
| 143 However, unless you take special steps, |
| 144 the extension's ID in the Chrome Web Store |
| 145 will be different from its ID in the package you created. |
| 146 This different ID might be a problem if you've |
| 147 distributed your extension package, |
| 148 because it allows users to install multiple versions of your extension, |
| 149 each with its own local data. |
| 150 </p> |
| 151 |
| 152 <p> |
| 153 If you want to keep the extension ID the same, |
| 154 follow these steps: |
| 155 </p> |
| 156 |
| 157 <ol> |
| 158 <li> Rename the private key that was generated |
| 159 when you created the <code>.crx</code> file to <code>key.pem</code>. </li> |
| 160 <li> Put <code>key.pem</code> in the top directory |
| 161 of your extension. </li> |
| 162 <li> Compress that directory into a ZIP file. </li> |
| 163 <li> Upload the ZIP file using the |
| 164 <a href="https://chrome.google.com/webstore/developer/dashboard">Chrome Deve
loper Dashboard</a>. </li> |
| 165 </ol> |
| 166 |
| 167 |
138 <h2>Packaging at the command line</h2> | 168 <h2>Packaging at the command line</h2> |
139 | 169 |
140 <p> | 170 <p> |
141 Another way to package extensions | 171 Another way to package extensions |
142 is by invoking <code>chrome.exe</code> at the command line. | 172 is by invoking <code>chrome.exe</code> at the command line. |
143 Use the <code>--pack-extension</code> flag | 173 Use the <code>--pack-extension</code> flag |
144 to specify the location of the extension's folder. | 174 to specify the location of the extension's folder. |
145 Use <code>--pack-extension-key</code> | 175 Use <code>--pack-extension-key</code> |
146 to specify the location of the extension's private key file. | 176 to specify the location of the extension's private key file. |
147 For example: | 177 For example: |
148 </p> | 178 </p> |
149 | 179 |
150 <pre> | 180 <pre> |
151 chrome.exe --pack-extension=c:\myext --pack-extension-key=c:\myext.pem | 181 chrome.exe --pack-extension=c:\myext --pack-extension-key=c:\myext.pem |
152 </pre> | 182 </pre> |
153 | 183 |
154 <p> | 184 <p> |
155 To suppress the dialog, | 185 To suppress the dialog, |
156 add <code>--no-message-box</code> to the command. | 186 add <code>--no-message-box</code> to the command. |
157 </p> | 187 </p> |
158 | 188 |
159 <h2>Package format and scripts</h2> | 189 <h2>Package format and scripts</h2> |
160 <p> | 190 <p> |
161 For more information on the format, as well as pointers to scripts you can use | 191 For more information on the format, as well as pointers to scripts you can use |
162 to create <code>.crx</code> files, see <a href="crx.html">CRX Package Format</a>
. | 192 to create <code>.crx</code> files, see <a href="crx.html">CRX Package Format</a>
. |
163 </p> | 193 </p> |
OLD | NEW |