Загрузка неопубликованных надстроек Office, использующих унифицированный манифест для Microsoft 365

Статья
02/14/2025

Процесс загрузки неопубликованного надстройки, использующего манифест Unified для Microsoft 365 , зависит от того, какое средство вы хотите использовать, а также от того, как был создан проект надстройки.

Примечание.

Надстройку, которая использует унифицированный манифест, можно загрузить в Office в Windows версии 2304 (сборка 16320.20000) или более поздней. В настоящее время его невозможно загрузить в Интернете, Mac или iPad.

Загрузка неопубликованных надстроек, созданных с помощью генератора Yeoman для надстроек Office (Yo Office)

Используйте процесс, описанный в разделе Загрузка неопубликованных приложений с помощью системного запроса, оболочки bash или терминала.

Загрузка неопубликованных приложений с помощью набора средств Teams

Сначала убедитесь, что классическое приложение Office, в которое вы хотите загрузить неопубликованное приложение, закрыто.
В Visual Studio Code откройте Набор средств Teams.
Требуется только для Outlook: в разделе Учетные записи убедитесь, что вы вошли в Microsoft 365.
Выберите Просмотр | выполнить в Visual Studio Code. В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите один из этих параметров, подходящий для вашей надстройки.
- Excel Desktop (Edge Chromium)
- Outlook Desktop (Edge Chromium)
- PowerPoint Desktop (edge Chromium)
- Word Desktop (Edge Chromium)
Нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут, после чего откроется классическая версия выбранного приложения Office. Теперь вы можете работать с надстройкой. Для надстройки Outlook убедитесь, что вы работаете в папке "Входящие"удостоверения учетной записи Microsoft 365.
Чтобы остановить отладку и удалить надстройку, выберите Запустить | остановить отладку в Visual Studio Code. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office.

Загрузка неопубликованных приложений с помощью системного запроса, оболочки Bash или терминала

Сначала убедитесь, что классическое приложение Office, в которое вы хотите загрузить неопубликованное приложение, закрыто.
Откройте системный запрос, оболочку bash или Visual Studio Code TERMINAL и перейдите к корню проекта.
Команда для загрузки неопубликованного надстройки зависит от того, когда был создан проект. Если раздел "scripts" файла package.json проекта содержит скрипт start:desktop, выполните ; в npm run start:desktopпротивном случае выполните команду npm run start. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут, после чего откроется ведущее приложение Office (Excel, Outlook, PowerPoint или Word).
Теперь вы можете работать с надстройкой.
Завершив работу с надстройкой, обязательно выполните команду npm run stop. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office.

Загрузка неопубликованных проектов NodeJS и npm

Для загрузки неопубликованных приложений можно использовать два инструмента.

Загрузка неопубликованных приложений с помощью средства Office-Addin-Debugging

Чтобы загрузить неопубликованную надстройку, выполните следующую команду. Эта команда помещает унифицированный манифест и файлы изображений двух значков, на которые ссылается свойство "значки" манифеста, в ZIP-файл и загружает его в приложение Office. Он также запускает сервер в отдельном окне NodeJS для размещения файлов надстройки на localhost. Дополнительные сведения об этой команде см. в разделе Office-Addin-Debugging.
```
npx office-addin-debugging start <relative-path-to-unified-manifest> desktop
```
При использовании office-addin-debugging для запуска надстройки всегда прерывайте сеанс с помощью следующей команды. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office.
```
npx office-addin-debugging stop <relative-path-to-unified-manifest>
```

Загрузка неопубликованных приложений с помощью интерфейса командной строки набора средств Teams (интерфейс командной строки)

Создайте ZIP-пакет вручную, выполнив следующие действия.
1. Откройте унифицированный манифест и прокрутите страницу до свойства icons. Обратите внимание на относительный путь к двум файлам изображений.
2. Используйте любую служебную программу ZIP, чтобы создать ZIP-файл, содержащий унифицированный манифест и два файла изображений. Файлы изображений должны иметь тот же относительный путь в ZIP-файле, что и в проекте. Например, если относительный путь — "assets/icon-64.png" и "assets/icon-128.png", необходимо включить папку assets с двумя файлами в ZIP-пакет.
3. Если папка содержит другие файлы, например файлы изображений, используемые на ленте Office, удалите их из ZIP-пакета. В нем должны быть только два файла изображений, указанные в свойстве icons (в дополнение к манифесту в корневом каталоге ZIP-пакета).
В корневой части проекта откройте командную строку или оболочку bash и выполните следующие команды.
```
npm install -g @microsoft/teamsapp-cli

teamsapp install --file-path <relative-path-to-zip-file>
```
При запуске надстройки с помощью интерфейса командной строки набора средств Teams всегда прерывайте сеанс с помощью следующей команды. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office. Замените "{GUID надстройки}" на GUID в свойстве id унифицированного манифеста.
```
teamsapp uninstall -manifest-id {GUID of the add-in}
```

Поделиться через