Команда settings (winget)

  • Статья

Команда settings инструмента winget используется для настройки работы клиента с Диспетчером пакетов Windows. Вы можете изменить значения по умолчанию и попробовать экспериментальные функции, включенные в клиенте.

Команда settings запустит текстовый редактор по умолчанию. В Windows по умолчанию запускается Блокнот. Рекомендуем использовать такой инструмент, как Visual Studio Code.

Примечание.

Его можно легко установить, введя команду winget install Microsoft.VisualStudioCode

Aliases

Для этой команды доступны следующие псевдонимы:

  • config

Использование команды settings средства winget

Запустите инструмент для редактирования JSON по умолчанию: winget settings

При первом запуске настроек они не будут указаны. В верхней части JSON-файла мы разместили ссылку для перехода к новым экспериментальным функциям и настройкам.

Приведенный ниже фрагмент кода является примером того, как должен выглядеть ваш файл параметров, если вы хотите включить или изменить некоторые из этих экспериментальных функций и параметров.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

Мы также определили схему для файла настроек. Это позволяет использовать клавишу TAB для перехода между настройками и синтаксисом, если редактор JSON поддерживает схемы JSON.

Примечание.

Экспериментальные функции доступны только в предварительных сборках. Инструкции по получению предварительной сборки можно найти в репозитории GitHub.

Изменение настроек

Для выпуска 1.0 Диспетчера пакетов Windows доступны перечисленные ниже настройки.

Параметры source

Настройки source предназначены для изменения конфигурации источника WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Положительное целое число представляет интервал обновления в минутах. Проверка обновлений происходит только при использовании источника. Нулевое значение отключает проверку обновлений для источника. Все остальные значения недопустимы.

  • Отключить: 0.
  • Значение по умолчанию: 5

Чтобы обновить источник вручную, используйте winget source update.

Параметры visual

Настройки visual используются для изменения визуальных элементов, отображаемых WinGet.

"visual": {
    "progressBar": "accent"
},

progressBar

Цвет индикатора выполнения, который WinGet отображает, если он не задан с помощью аргументов.

  • accent (по умолчанию)
  • retro
  • rainbow

Параметры installBehavior

Настройки installBehavior влияют на поведение по умолчанию при установке пакетов и их обновлении (если применимо).

disableInstallNotes

Поведение disableInstallNotes влияет на то, отображаются ли заметки об установке после успешной установки. Если значение не задано или недопустимо, по умолчанию используется false.

    "installBehavior": {
        "disableInstallNotes": true
    },

Параметр portablePackageUserRoot

Параметр portablePackageUserRoot влияет на корневой каталог по умолчанию, в котором пакеты устанавливаются в область User. Этот параметр применяется только к пакетам с типом установщика portable. Если значение не задано или недопустимо, по умолчанию используется %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

Примечание. Это значение параметра должно быть абсолютным путем.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

Параметр portablePackageMachineRoot

Параметр portablePackageMachineRoot влияет на корневой каталог по умолчанию, в котором пакеты устанавливаются в область Machine. Этот параметр применяется только к пакетам с типом установщика portable. Если значение не задано или недопустимо, по умолчанию используется %PROGRAMFILES%/WinGet/Packages/.

Примечание. Это значение параметра должно быть абсолютным путем.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

Параметры preferences и requirements

Некоторые настройки дублируются в preferences и requirements.

  • Настройка preferences влияет на способ сортировки различных доступных параметров при выборе одного из них. Например, областью установки пакета по умолчанию является текущий пользователь, но если такую область использовать нельзя, будет выбран установщик на уровне компьютера.
  • Настройка requirements фильтрует параметры, что может привести к получению пустого списка и сбою установки. В предыдущем примере требование к использованию области пользователя приведет к отсутствию применимых установщиков и ошибке.

Аргументы, передаваемые в командной строке, будут переопределять соответствующую настройку requirement в течение действия этой команды.

область

Поведение scope влияет на возможность установки пакета для текущего пользователя или для всего компьютера. Соответствующий параметр --scope использует те же значения (user или machine). Ознакомьтесь с известными проблемами, связанными с установкой пакетов область.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

локаль

Поведение locale влияет на выбор установщика, основанный на языковом стандарте установщика. Соответствующий параметр --locale использует тег языка bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

architectures

Поведение architectures влияет на то, какие архитектуры будут выбраны при установке пакета. Соответствующий параметр имеет значение --architecture. Обратите внимание, что можно выбрать только архитектуры, совместимые с вашей системой.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

installerTypes

Поведение installerTypes влияет на типы установщиков при установке пакета. Соответствующий параметр имеет значение --installer-type.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

uninstallBehavior

Параметры uninstallBehavior влияют на поведение по умолчанию при удалении пакетов (если применимо).

purgePortablePackage

Поведение purgePortablePackage влияет на поведение по умолчанию для удаления переносимого пакета. Если задано значение true, удаление приведет к удалению всех файлов и каталогов, относящихся к пакету portable. Этот параметр применяется только к пакетам с типом установщика portable. Если значение не задано или недопустимо, по умолчанию используется false.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

downloadBehavior

Параметры downloadBehavior влияют на поведение по умолчанию при скачивании пакетов.

defaultDownloadDirectory

Этот defaultDownloadDirectory параметр влияет на каталог по умолчанию, в который загружаются пакеты. Если значение не задано или недопустимо, по умолчанию используется %USERPROFILE%/Downloads.

Примечание. Это значение параметра должно быть абсолютным путем.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Параметры telemetry

Настройки telemetry управляют тем, записывает ли winget события трассировки событий Windows, которые могут отправляться в корпорацию Майкрософт при установке Windows по умолчанию.

См. сведения о телеметрии и наше основное заявление о конфиденциальности.

disable

"telemetry": {
    "disable": true
},

Если задано значение true, то настройка telemetry.disable отключит запись каких-либо событий программой.

параметры сети

Настройки network влияют на то, как winget использует сеть для получения пакетов и метаданных.

Downloader

Настройка downloader определяет, какой код используется при скачивании пакетов. Значение по умолчанию — default, что может быть любым из вариантов в зависимости от нашего определения.

wininet использует API-интерфейсы WinINet, а do использует службу оптимизации доставки.

"network": {
    "downloader": "do"
}

Параметры logging

Параметры logging управляют уровнем детализации в файлах журнала. --verbose-logs переопределяет этот параметр и всегда создает подробный журнал.

"logging": {
    "level": "verbose"
}

level

Доступны следующие уровни ведения журнала. Если значение не задано или недопустимо, по умолчанию используется info.

  • verbose
  • info
  • предупреждений (не рекомендуется)
  • error
  • критический

Включение экспериментальных функций

Чтобы узнать, какие экспериментальные функции вам доступны, см. https://aka.ms/winget-settings.