设置重写

扩展程序可以使用设置重写的方式修改 Chrome 浏览器设置。

主页、搜索引擎和起始页

如下例子演示如何在扩展程序的清单文件中修改主页、搜索引擎和起始页。使用设置 API 的网站必须在 Google 网站站长工具中经过验证，并且要和 Chrome 网上应用店中的项目关联。注意，如果您验证了某个域名的所有权（例如 http://example.com），您可以在扩展程序中使用任意子域名或网页（例如 http://app.example.com 或 http://example.com/page.html）。

{
  "name": "我的扩展程序",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://www.foo.__MSG_url_domain__/image?q={searchTerms}",
        "search_url_post_params": "search_lang=__MSG_url_domain__",
        "suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
        "instant_url_post_params": "instant_lang=__MSG_url_domain__",
        "image_url_post_params": "image_lang=__MSG_url_domain__",
        "alternate_urls": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

注意： homepage、search_provider 以及 startup_pages 的设置重写只能在 Dev 分支的 Chrome 浏览器中使用。

自定义值

清单文件中的值可以以下列方式自定义：

search_provider、homepage 和 startup_pages 属性可以使用 chrome.i18n API 本地化。
对于外部扩展程序来说，search_provider、homepage 和 startup_pages 的 URL 值可以使用注册表中指定的参数。在“update_url”（参见这里的说明）所在位置创建新的注册表项，名为“install_parameters”，值数据为任意字符串：
```
{
    "update_url": "https://clients2.google.com/service/update2/crx",
    "install_parameter": "值"
  }
```
清单文件 URL 中所有字串 "__PARAM__" 都会替换成“install_parameter”值。如果没有指定“install_parameters”，"__PARAM__" 全都会被删除。注意，"__PARAM__" 不能是主机名的一部分，必须在 URL 中第一个“/”之后出现。

参考

扩展程序可以在清单文件中重写如下一个或多个属性：

homepage (string)

您指定的主页。

search_provider (object)

某个搜索引擎。

类型	属性	描述
string	（可选） name	向用户显示的搜索引擎名称。如果设置了 prepopulated_id 的话，该属性可以省略。
string	（可选） keyword	搜索引擎的多功能框关键字。如果设置了 prepopulated_id 的话，该属性可以省略。
string	（可选） favicon_url	搜索引擎的图标 URL。如果设置了 prepopulated_id 的话，该属性可以省略。
string	search_url	搜索引擎使用的搜索 URL。
string	（可选） encoding	搜索条目的编码。如果设置了 prepopulated_id 的话，该属性可以省略。
string	（可选） suggest_url	如果省略，该搜索引擎不支持建议。
string	（可选） instant_url	如果省略，该搜索引擎不支持即搜即得。
string	（可选） image_url	如果省略，该搜索引擎不支持图片搜索。
string	（可选） search_url_post_params	search_url 的 POST 参数字符串。
string	（可选） suggest_url_post_params	suggest_url 的 POST 参数字符串。
string	（可选） instant_url_post_params	instant_url 的 POST 参数字符串。
string	（可选） image_url_post_params	image_url 的 POST 参数字符串。
array of string	（可选） alternate_urls	除了 `search_url` 以外还可以使用的 URL 列表。
integer	（可选） prepopulated_id	从 Chrome 36 开始支持。 Chrome 中内建搜索引擎的标识符。
boolean	is_default	指定是否设置为默认搜索引擎。

startup_pages (array of string)

长度为 1 的数组，包含作为起始页的 URL。