Таблица
17.5.
Объект Install (* Действие откладывается до завершения установки?)
| Константа, свойство или метод |
* |
Использование |
| SKIN (1), LOCALE (2), CONTENT (4),
PACKAGE (7), DELAYED_CHROME(16)
|
|
Значения битовой маски флагов свойств и registerChrome() ; использование DELAYED_CHROME задерживает регистрацию до следующего старта платформы. |
| Number buildID |
|
Номер билда данной установки платформы (e.g., 2002060411) |
| Error constants (see Table 17.6) |
|
|
| String platform |
|
Содержит тип операционной системы и версию, наподобие window.navigator.userAgent
|
| String jarfile |
|
Полный путь к копии файла XPI на локальном компьютере |
| String archive |
|
Полный путь к копии файла XPI на локальном компьютере. То же, что и jarfile
|
| String arguments |
|
В URL файла XPI содержит любую строку после "?", или null
|
| String url |
|
Полный URL файла XPI, переданный install() или installChrome()
|
| Number flags |
|
Флаги, переданные методом installChrome() объекта InstallTrigger
|
| Number _finalStatus |
|
Значение, возвращаемое счетчику в диалоговом окне удаленной установки |
| Boolean _installedFiles |
|
Получает значение False, если вызван метод cancelInstall()
|
| File File |
|
Ссылка на объект File
|
| Object Install |
|
Ссылка на глобальный объект Install
|
| Number addDirectory(String XPItree) Number addDirectory(String name, String XPItree, FileSpecObject OSpath, String localPath) Number addDirectory(String name, String version, String XPItree, FileSpecObject OSpath, String localPath) Number addDirectory(String name, InstallVersion version, String XPItree, FileSpecObject OSpath, String localPath) |
+ |
Копирует указанный путь XPItree в локальную файловую систему; устанавливает с именем текущего приложения или регистровым именем приложения, если оно указано; всегда устанавливает с номером последней версии, или, если версия указана, сравнивает указанную версию с имеющейся, если имеется более новая, процесс установки прекращается; если место для копирования не указано, копирует в текущую директорию, если указаны OSpath и localPath, соединяет их в строку и копирует содержание XPItree по полученному пути; возвращает ошибки |
| Number addFile(String XPIfile) Number addFile(String name, String version, String XPIfile, FileSpecObject Ospath, String localPath, [Boolean force]) Number addFile(String name, InstallVersion version, String XPIfile, FileSpecObject OSpath, String localPath, [Boolean force]) |
+ |
Копирует файлы из XPI-архива в локальную файловую систему; устанавливает в текущую директорию, текущее приложение и текущую версию, если иное не указано; если указано регистровое имя, используется оно, а не текущее имя; если указана версия, не устанавливает приложение, если имеющееся приложение новее устанавливаемого; если указаны OSpath и localPath, объединяет их и устанавливает файлы по полученному пути; если force имеет значение true, не проверяет значение версии, в этом случае установка производится всегда; возвращает ошибки |
| Null alert(String value) |
|
Отображает окно модального диалога, ожидающее подтверждения пользователя |
| void cancelInstall() void cancelInstall(Number reason) |
|
Не выполняются никакие предписанные инструкции; если указана причина, она указывается в коде ошибки, в противном случае указывается NSTALL_CANCELLED
|
| Boolean confirm (String value) |
|
Отображает окно модального диалога, ожидающее принятия или отклонения условия пользователем; в случае отклонения возвращает false
|
| Number execute(String XPIpath, String
args, Boolean blocking)
Number execute(String XPIpath, String
args);
Number execute(String XPIpath);
|
|
Выполнить программу, расположенную по адресу XPIpath в архиве XPI; можно передать ей системно-зависимую строку аргументов; можно, присвоить параметру blocking значение true, это задерживает процесс установки до окончания выполнения программы; значение blocking по умолчанию равно false
|
| Number gestalt(String selector) |
|
Только для платформы Macintosh - возвращает значение селектора согласно Gestalt Manager; в противном случае null
|
| FileSpecObject getComponentFolder(String name) FileSpecObject getComponentFolder(String name, String subpath) |
|
возвращает имя папки из subpart имени приложения, если subpath присутствует; в противном случае null
|
| FileSpecObject getFolder(String keyword) FileSpecObject getFolder(String keyword, String subpath) FileSpecObject getFolder(FileSpecObject folder, String subpath) |
|
Возвращает имя папки, соответствующее keyword, или подпапки этой папки, если subpart присутствует: если subpart имя архива JAR, а не папки, архив прочитывается и рассматривается как папка; null в случае неудачи |
| Number getLastError() |
|
Возвращает последний код ошибки или SUCCESS
|
| WinProfile getWinProfile(FileSpecObject folder, String filename) |
|
Возвращает объект WinProfile указанного в файле .INI; возвращает null, если ОС не Microsoft Windows |
| WinReg getWinRegistry() |
|
Возвращает объект WinReg
|
| Number initInstall(String text_name, String reg_name, String version) Number initInstall(String text_name, String reg_name, InstallVersion version); |
|
Начинает назначенный процесс данной установки; устанавливает имя данного приложения в text_name, имя регистра reg_name, версию - в version ; возвращает ошибки |
| Object loadResources(String XPIpath) |
|
Возвращает JavaScript-объект, моделируемый на основании файла свойств (stringbundle) в архиве XPI; этот файл свойств имеет относительное имя пути XPIpath; каждое свойство в фале появляется как свойство объекта JavaScript; возвращает null в случае ошибки |
| Null logComment(String text) |
+ |
Записывает text, с некоторым форматированием, в файл install.log |
| patch() |
|
Этот метод позволяет обновить данный файл на основе побайтной дельты; не рекомендуется к использованию, задействуйте вместо этого addFile()
|
| Number performInstall() |
|
Выполняет все предписанные задачи и возвращает статус ошибки
|
| Number registerChrome(Number flags, FileSpecObject folder) Number registerChrome(Number flags, FileSpecObject folder, String rdfpath) |
|
Заставляет платформу перепрочитать chrome на предмет обновления оверлеев, локалей и скинов; flags сообщает, какие типы информации будут регистрироваться (см. ниже), folder - местоположение рассматриваемых файлов, rdfpath - необязательный подпуть (включающий имя файла) к файлу ontents.rdf для оверлеев |
| Number refreshPlugins() Number refreshPlugins Boolean reloadPages) |
|
Заставляет платформу обновить доступные плагины и перезагрузить все окна, зависящие от них; если reloadPages имеет значение false, перезагрузки не происходит |
| void resetError() void resetError(Number error) |
|
Устанавливает последнюю полученную ошибку в ноль или данное значение, если оно имеется |
| Number setPackageFolder(FileSpecObject folder) |
|
Заменяет значение текущей директории на указанную папку |
| Number uninstall(String name) |
|
Назначает имя регистра указанного приложения к удалению; возвращает код ошибки
|
