| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ | 5 #ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ |
| 6 #define CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ | 6 #define CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 #include <vector> | 9 #include <vector> |
| 10 | 10 |
| 11 #include "base/basictypes.h" | 11 #include "base/basictypes.h" |
| 12 | 12 |
| 13 namespace base { |
| 14 class FilePath; |
| 15 } |
| 16 |
| 13 namespace crypto { | 17 namespace crypto { |
| 14 class RSAPrivateKey; | 18 class RSAPrivateKey; |
| 15 } | 19 } |
| 16 | 20 |
| 17 class FilePath; | |
| 18 | |
| 19 namespace extensions { | 21 namespace extensions { |
| 20 | 22 |
| 21 // This class create an installable extension (.crx file) given an input | 23 // This class create an installable extension (.crx file) given an input |
| 22 // directory that contains a valid manifest.json and the extension's resources | 24 // directory that contains a valid manifest.json and the extension's resources |
| 23 // contained within that directory. The output .crx file is always signed with a | 25 // contained within that directory. The output .crx file is always signed with a |
| 24 // private key that is either provided in |private_key_path| or is internal | 26 // private key that is either provided in |private_key_path| or is internal |
| 25 // generated randomly (and optionally written to |output_private_key_path|. | 27 // generated randomly (and optionally written to |output_private_key_path|. |
| 26 class ExtensionCreator { | 28 class ExtensionCreator { |
| 27 public: | 29 public: |
| 28 ExtensionCreator(); | 30 ExtensionCreator(); |
| 29 | 31 |
| 30 // Settings to specify treatment of special or ignorable error conditions. | 32 // Settings to specify treatment of special or ignorable error conditions. |
| 31 enum RunFlags { | 33 enum RunFlags { |
| 32 kNoRunFlags = 0x0, | 34 kNoRunFlags = 0x0, |
| 33 kOverwriteCRX = 0x1, | 35 kOverwriteCRX = 0x1, |
| 34 kRequireModernManifestVersion = 0x2, | 36 kRequireModernManifestVersion = 0x2, |
| 35 }; | 37 }; |
| 36 | 38 |
| 37 // Categories of error that may need special handling on the UI end. | 39 // Categories of error that may need special handling on the UI end. |
| 38 enum ErrorType { kOtherError, kCRXExists }; | 40 enum ErrorType { kOtherError, kCRXExists }; |
| 39 | 41 |
| 40 bool Run(const FilePath& extension_dir, | 42 bool Run(const base::FilePath& extension_dir, |
| 41 const FilePath& crx_path, | 43 const base::FilePath& crx_path, |
| 42 const FilePath& private_key_path, | 44 const base::FilePath& private_key_path, |
| 43 const FilePath& private_key_output_path, | 45 const base::FilePath& private_key_output_path, |
| 44 int run_flags); | 46 int run_flags); |
| 45 | 47 |
| 46 // Returns the error message that will be present if Run(...) returned false. | 48 // Returns the error message that will be present if Run(...) returned false. |
| 47 std::string error_message() { return error_message_; } | 49 std::string error_message() { return error_message_; } |
| 48 | 50 |
| 49 ErrorType error_type() { return error_type_; } | 51 ErrorType error_type() { return error_type_; } |
| 50 | 52 |
| 51 private: | 53 private: |
| 52 // Verifies input directory's existence. |extension_dir| is the source | 54 // Verifies input directory's existence. |extension_dir| is the source |
| 53 // directory that should contain all the extension resources. |crx_path| is | 55 // directory that should contain all the extension resources. |crx_path| is |
| 54 // the path to which final crx will be written. | 56 // the path to which final crx will be written. |
| 55 // |private_key_path| is the optional path to an existing private key to sign | 57 // |private_key_path| is the optional path to an existing private key to sign |
| 56 // the extension. If not provided, a random key will be created (in which case | 58 // the extension. If not provided, a random key will be created (in which case |
| 57 // it is written to |private_key_output_path| -- if provided). | 59 // it is written to |private_key_output_path| -- if provided). |
| 58 // |flags| is a bitset of RunFlags values. | 60 // |flags| is a bitset of RunFlags values. |
| 59 bool InitializeInput(const FilePath& extension_dir, | 61 bool InitializeInput(const base::FilePath& extension_dir, |
| 60 const FilePath& crx_path, | 62 const base::FilePath& crx_path, |
| 61 const FilePath& private_key_path, | 63 const base::FilePath& private_key_path, |
| 62 const FilePath& private_key_output_path, | 64 const base::FilePath& private_key_output_path, |
| 63 int run_flags); | 65 int run_flags); |
| 64 | 66 |
| 65 // Validates the manifest by trying to load the extension. | 67 // Validates the manifest by trying to load the extension. |
| 66 bool ValidateManifest(const FilePath& extension_dir, | 68 bool ValidateManifest(const base::FilePath& extension_dir, |
| 67 crypto::RSAPrivateKey* key_pair, | 69 crypto::RSAPrivateKey* key_pair, |
| 68 int run_flags); | 70 int run_flags); |
| 69 | 71 |
| 70 // Reads private key from |private_key_path|. | 72 // Reads private key from |private_key_path|. |
| 71 crypto::RSAPrivateKey* ReadInputKey(const FilePath& private_key_path); | 73 crypto::RSAPrivateKey* ReadInputKey(const base::FilePath& private_key_path); |
| 72 | 74 |
| 73 // Generates a key pair and writes the private key to |private_key_path| | 75 // Generates a key pair and writes the private key to |private_key_path| |
| 74 // if provided. | 76 // if provided. |
| 75 crypto::RSAPrivateKey* GenerateKey(const FilePath& private_key_path); | 77 crypto::RSAPrivateKey* GenerateKey(const base::FilePath& private_key_path); |
| 76 | 78 |
| 77 // Creates temporary zip file for the extension. | 79 // Creates temporary zip file for the extension. |
| 78 bool CreateZip(const FilePath& extension_dir, const FilePath& temp_path, | 80 bool CreateZip(const base::FilePath& extension_dir, const base::FilePath& temp
_path, |
| 79 FilePath* zip_path); | 81 base::FilePath* zip_path); |
| 80 | 82 |
| 81 // Signs the temporary zip and returns the signature. | 83 // Signs the temporary zip and returns the signature. |
| 82 bool SignZip(const FilePath& zip_path, | 84 bool SignZip(const base::FilePath& zip_path, |
| 83 crypto::RSAPrivateKey* private_key, | 85 crypto::RSAPrivateKey* private_key, |
| 84 std::vector<uint8>* signature); | 86 std::vector<uint8>* signature); |
| 85 | 87 |
| 86 // Export installable .crx to |crx_path|. | 88 // Export installable .crx to |crx_path|. |
| 87 bool WriteCRX(const FilePath& zip_path, | 89 bool WriteCRX(const base::FilePath& zip_path, |
| 88 crypto::RSAPrivateKey* private_key, | 90 crypto::RSAPrivateKey* private_key, |
| 89 const std::vector<uint8>& signature, | 91 const std::vector<uint8>& signature, |
| 90 const FilePath& crx_path); | 92 const base::FilePath& crx_path); |
| 91 | 93 |
| 92 // Holds a message for any error that is raised during Run(...). | 94 // Holds a message for any error that is raised during Run(...). |
| 93 std::string error_message_; | 95 std::string error_message_; |
| 94 | 96 |
| 95 // Type of error that was raised, if any. | 97 // Type of error that was raised, if any. |
| 96 ErrorType error_type_; | 98 ErrorType error_type_; |
| 97 | 99 |
| 98 DISALLOW_COPY_AND_ASSIGN(ExtensionCreator); | 100 DISALLOW_COPY_AND_ASSIGN(ExtensionCreator); |
| 99 }; | 101 }; |
| 100 | 102 |
| 101 } // namespace extensions | 103 } // namespace extensions |
| 102 | 104 |
| 103 #endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ | 105 #endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_ |
| OLD | NEW |