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

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

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

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

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

1. Сначала убедитесь, что классическое приложение Office, в которое вы хотите загрузить неопубликованное приложение, закрыто.

2. В Visual Studio Code откройте Набор средств Teams.

3. Требуется только для Outlook: в разделе Учетные записи убедитесь, что вы вошли в Microsoft 365.

4. Выберите Просмотр | выполнить в Visual Studio Code. В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите один из этих параметров, подходящий для вашей надстройки.

   • Excel Desktop (Edge Chromium)
   • Outlook Desktop (Edge Chromium)
   • PowerPoint Desktop (edge Chromium)
   • Word Desktop (Edge Chromium)

5. Нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут, после чего откроется классическая версия выбранного приложения Office. Теперь вы можете работать с надстройкой. Для надстройки Outlook убедитесь, что вы работаете в папке "Входящие"удостоверения учетной записи Microsoft 365.

6. Чтобы остановить отладку и удалить надстройку, выберите Запустить | остановить отладку в Visual Studio Code. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office.

   Примечание.

   Если предыдущий шаг не повлияет, удалите надстройку, открыв терминал в Visual Studio Code, а затем выполните шаг удаления (последний шаг) раздела Загрузка неопубликованных приложений с помощью системного запроса, оболочки Bash или терминала.

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

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

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

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

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

1. Чтобы загрузить неопубликованную надстройку, выполните следующую команду. Эта команда помещает унифицированный манифест и файлы изображений двух значков, на которые ссылается свойство "значки" манифеста, в ZIP-файл и загружает его в приложение Office. Он также запускает сервер в отдельном окне NodeJS для размещения файлов надстройки на localhost. Дополнительные сведения об этой команде см. в разделе Office-Addin-Debugging.

   npx office-addin-debugging start <relative-path-to-unified-manifest> desktop
   

2. При использовании office-addin-debugging для запуска надстройки всегда прерывайте сеанс с помощью следующей команды. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office.

   npx office-addin-debugging stop <relative-path-to-unified-manifest>
   

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

1. Создайте ZIP-пакет вручную, выполнив следующие действия.

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

2. В корневой части проекта откройте командную строку или оболочку bash и выполните следующую команду, чтобы установить интерфейс командной строки набора средств Teams.

   npm install -g @microsoft/teamsapp-cli
   

3. Выполните следующую команду, чтобы загрузить неопубликованную надстройку.

   teamsapp install --file-path <relative-path-to-zip-file>
   

   Важно!

   Эта команда возвращает некоторые сведения о надстройке, включая автоматически сформированный идентификатор заголовка, как показано в следующем примере.

   

   Этот идентификатор заголовка потребуется для завершения сеанса загрузки и отладки неопубликованных приложений. Он записывается на компьютерах Windows в следующем разделе реестра:

   HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\OutlookSideloadManifestPath\TitleId

   Строка "Outlook" указана в имени ключа по историческим причинам, но она применяется к любой надстройке, установленной с помощью интерфейса командной строки набора средств Teams.

   Записывается только последняя надстройка, установленная с интерфейсом командной строки. Если вы загружаете неопубликованную надстройку с помощью интерфейса командной строки перед удалением более ранней надстройки, установленной с помощью CLI, то в реестре отсутствует запись идентификатора заголовка предыдущей надстройки. Поэтому рекомендуется также сохранить его в текстовом файле в корне проекта и присвоить файлу имяTitleID.txt на компьютерах Mac и Windows.

4. При запуске надстройки с помощью интерфейса командной строки набора средств Teams всегда прерывайте сеанс с помощью следующей команды. Закрытие окна сервера не приводит к надежной остановке сервера, а закрытие приложения Office не приводит к отмене запроса надстройки Office. Замените "{title ID}" идентификатором заголовка надстройки, включая префикс "U_". например, U_90d141c6-cf4f-40ee-b714-9df9ea593f39.

   teamsapp uninstall --mode title-id --title-id {title ID} --interactive false
   

   Важно!

   В документации по команде uninstall описывается способ использования идентификатора манифеста надстройки вместо идентификатора заголовка. Из-за ошибки в API, вызываемом CLI, этот параметр в настоящее время не работает. Необходимо использовать указанную uninstall выше команду и включить --interactive false параметр .