chrome.management

描述 chrome.management API 可以用来管理已经安装并且正在运行的应用或应用
可用版本 从 Chrome 8 开始支持。
权限 "management"

清单文件

您必须在应用的清单文件中声明 "management" 权限才能使用管理 API。例如:

      {
        "name": "我的应用",
        ...
        "permissions": [
          "management"
        ],
        ...
      }

management.getPermissionWarningsByManifest management.uninstallSelf 不需要 "management" 权限。

摘要

类型
IconInfo
ExtensionInfo
方法
getAll chrome.management.getAll(function callback)
get chrome.management.get(string id, function callback)
getPermissionWarningsById chrome.management.getPermissionWarningsById(string id, function callback)
getPermissionWarningsByManifest chrome.management.getPermissionWarningsByManifest(string manifestStr, function callback)
setEnabled chrome.management.setEnabled(string id, boolean enabled, function callback)
uninstall chrome.management.uninstall(string id, object options, function callback)
uninstallSelf chrome.management.uninstallSelf(object options, function callback)
事件
onInstalled
onUninstalled
onEnabled
onDisabled

类型

IconInfo

属于应用、应用或主题背景的图标的有关信息。
属性
integer size

代表图标宽度和高度的一个整数,可能的值包括(但不限于)128、48、24 和 16。

string url

该图标图像的 URL。要显示一个灰度版本的图标(例如表示应用已禁用),请在 URL 后附加 ?grayscale=true

ExtensionInfo

已安装的应用、应用或主题背景的有关信息。
属性
string id

应用的唯一标识符。

string name

应用、应用或主题背景的名称。

string shortName

从 Chrome 31 开始支持。

应用、应用或主题背景名称的简短版本。

string description

从 Chrome 9 开始支持。

应用、应用或主题背景的描述。

string version

应用、应用或主题背景的版本

boolean mayDisable

从 Chrome 12 开始支持。

用户是否能禁用或卸载该应用。

boolean enabled

该应用当前是否已启用。

enum of "unknown", or "permissions_increase" (可选)
disabledReason

从 Chrome 17 开始支持。

项目被禁用的原因。

boolean isApp

从 Chrome 33 开始弃用请使用 management.ExtensionInfo.type

如果是应用则为 true。

enum of "extension", "hosted_app", "packaged_app", "legacy_packaged_app", or "theme" type

从 Chrome 23 开始支持。

该应用、应用或主题背景的类型。

string (可选)
homepageUrl

从 Chrome 11 开始支持。

该应用、应用或主题背景的主页 URL。

string (可选)
updateUrl

从 Chrome 16 开始支持。

该应用、应用或主题背景的更新 URL。

boolean offlineEnabled

从 Chrome 15 开始支持。

该应用、应用或主题背景是否声明它具有离线支持。

string optionsUrl

该项目的选项页面 URL(如果有的话)。

array of IconInfo (可选)
icons

图标信息列表。注意这只反映声明在清单文件中的信息,URL 指定的实际图像可能比声明的更大或更小,所以您引用这些图像时可能要考虑在 标签中显式使用 width 和 height 属性。有关更多细节,请参见清单文件:icons

array of string permissions

从 Chrome 9 开始支持。

返回 API 权限列表。

array of string hostPermissions

从 Chrome 9 开始支持。

返回主机权限列表。

enum of "admin", "development", "normal", "sideload", or "other" installType

从 Chrome 22 开始支持。

应用是如何安装的,为下列值之一:
"admin" 表示应用由于管理策略而安装;
"development" 表示应用以未打包形式在开发者模式下加载;
"normal" 表示应用由 .crx 文件正常安装;
"sideload" 表示应用由计算机上的其他软件安装;
"other" 表示应用通过其他方式安装。

方法

getAll

chrome.management.getAll(function callback)

返回已安装的应用和应用的信息列表。

参数
function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function(array of ExtensionInfo result) {...};
array of ExtensionInfo result

get

chrome.management.get(string id, function callback)

从 Chrome 9 开始支持。

返回已安装且具有指定标识符的应用、应用或主题背景的有关信息。

参数
string id

来自 management.ExtensionInfo 项目的标识符。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function( ExtensionInfo result) {...};
ExtensionInfo result

getPermissionWarningsById

chrome.management.getPermissionWarningsById(string id, function callback)

从 Chrome 15 开始支持。

返回指定应用标识符所对应的权限警告列表。

参数
string id

已安装的应用的标识符。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function(array of string permissionWarnings) {...};
array of string permissionWarnings

getPermissionWarningsByManifest

chrome.management.getPermissionWarningsByManifest(string manifestStr, function callback)

从 Chrome 15 开始支持。

返回指定应用清单文件字符串对应的权限警告列表。注意,这一函数不需要在清单文件中请求 "management"(管理)权限就可以使用。

参数
string manifestStr

应用清单文件的 JSON 字符串。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function(array of string permissionWarnings) {...};
array of string permissionWarnings

setEnabled

chrome.management.setEnabled(string id, boolean enabled, function callback)

启用或禁用一个应用或应用。

参数
string id

该参数应该为来自 management.ExtensionInfo 项目的标识符。

boolean enabled

应该启用还是禁用该项目。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function() {...};

uninstall

chrome.management.uninstall(string id, object options, function callback)

卸载当前已安装的某个应用或应用。

参数
string id

该参数应该为来自 management.ExtensionInfo 项目的标识符。

object (可选)
options

从 Chrome 21 开始支持。

boolean (可选)
showConfirmDialog

是否显示确认卸载对话框提示用户,如果是卸载自己则默认为 false,如果应用卸载其他应用,则忽略该参数,始终显示对话框。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function() {...};

uninstallSelf

chrome.management.uninstallSelf(object options, function callback)

从 Chrome 26 开始支持。

卸载调用该方法的应用。注意,这一函数不需要在清单文件中请求 "management"(管理)权限就可以使用。

参数
object (可选)
options
boolean (可选)
showConfirmDialog

是否显示确认卸载对话框提示用户,默认为 false。

function (可选)
callback

如果您指定了 callback 参数,它应该是一个如下形式的函数:

function() {...};

事件

onInstalled

安装应用或应用时产生。

addListener

chrome.management.onInstalled.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function( ExtensionInfo info) {...};
ExtensionInfo info

onUninstalled

应用或应用卸载时产生。

addListener

chrome.management.onUninstalled.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function(string id) {...};
string id

卸载的应用、应用或主题背景的标识符。

onEnabled

应用或应用启用时产生。

addListener

chrome.management.onEnabled.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function( ExtensionInfo info) {...};
ExtensionInfo info

onDisabled

应用或应用禁用时产生。

addListener

chrome.management.onDisabled.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function( ExtensionInfo info) {...};
ExtensionInfo info