Загрузка неопубликованных надстроек Office в Office в Интернете

  • Статья

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

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

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

  • Ведущее приложение (например, Excel, Word, Outlook)
  • Какое средство создало проект надстройки (например, Visual Studio, генератор Yeoman для надстроек Office или ни один)
  • Загружаете ли вы неопубликованные данные в Office в Интернете с учетной записью Майкрософт или учетной записью в клиенте Microsoft 365

В следующем списке перейдите к разделу или статье, которые соответствуют вашему сценарию. Обратите внимание, что первый сценарий в списке относится к надстройкам Outlook. Остальные сценарии применяются к надстройкам, отличным от Outlook.

Загрузка надстройки, созданной Yeoman, в Office в Интернете

Этот процесс поддерживается только для Excel, OneNote, PowerPoint и Word. В этом примере проекта предполагается, что вы используете проект, созданный с помощью генератора Yeoman для надстроек Office.

  1. Откройте Office в Интернете или OneDrive. С помощью параметра Создать создайте документ в Excel, OneNote, PowerPoint или Word. В этом новом документе выберите Общий доступ, Копировать ссылку и скопируйте URL-адрес.

  2. Откройте командную строку от имени администратора. В командной строке, начиная с корневого каталога проекта, выполните следующую команду. Замените "{url}" скопированным URL-адресом.

    Примечание.

    Если вы разрабатываете на компьютере Mac, заключите в одинарные {url} кавычки. Не делайте этого в Windows.

    npm run start:web -- --document {url}

    Ниже приведены примеры.

    • npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R
    • npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp
    • npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP

    Если надстройка не загружает неопубликованное приложение в документе, вручную загрузите ее, следуя инструкциям в разделе Ручная загрузка неопубликованных надстроек для Office в Интернете.

  3. При первом использовании этого метода для загрузки неопубликованного надстройки в Интернете появится диалоговое окно с запросом на включение режима разработчика. Установите флажок Включить режим разработчика сейчас и нажмите кнопку ОК.

  4. Появится второе диалоговое окно с запросом на регистрацию манифеста надстройки Office с компьютера. Выберите Да.

  5. Надстройка установлена. Если у него есть команда надстройки, она должна появиться на ленте или в контекстном меню. Если это надстройка области задач без команд надстройки, должна появиться область задач.

Загрузка неопубликованных надстроек в Интернете при использовании Visual Studio

Если вы используете Visual Studio для разработки надстройки, нажмите клавишу F5 , чтобы открыть документ Office в классическом office , создать пустой документ и загрузить неопубликованную надстройку. Если вы хотите загрузить неопубликованное Office в Интернете, процесс загрузки неопубликованных приложений аналогичен загрузке неопубликованных приложений вручную в Интернет. Единственное отличие заключается в том, что необходимо обновить значение элемента SourceURL и, возможно, других элементов в манифесте, чтобы включить полный URL-адрес, где развернута надстройка.

  1. В Visual Studio выберите Вид>окна свойств.

  2. В обозревателе решений выберите веб-проект. При этом в окне Свойства отображаются свойства проекта.

  3. В окне "Свойства" скопируйте URL-адрес SSL.

  4. В проекте надстройки откройте XML-файл манифеста. Обязательно редактировать исходный XML-код. Для некоторых типов проектов Visual Studio откроет визуальное представление XML, которое не будет работать на следующем шаге.

  5. Найдите и замените все экземпляры ~remoteAppUrl/ только что скопированным URL-адресом SSL. Вы увидите несколько замен в зависимости от типа проекта, а новые URL-адреса будут выглядеть примерно так: https://localhost:44300/Home.html.

  6. Сохраните XML-файл.

  7. В Обозреватель решений откройте контекстное меню веб-проекта (например, щелкнув его правой кнопкой мыши), а затем выберите ОтладкаЗапуск нового экземпляра>. При этом веб-проект запускается без запуска Office.

  8. С Office в Интернете загрузите неопубликованную надстройку, выполнив действия, описанные в разделе Загрузка неопубликованного надстройки вручную в Office в Интернете.

Загрузка неопубликованных приложений вручную в Office в Интернете

Этот метод не использует командную строку и может выполняться с помощью команд только в ведущем приложении (например, Excel).

  1. Откройте Office в Интернете. Откройте документ в Excel, OneNote, PowerPoint или Word.

  2. Выберите Главная>надстройки, а затем — Другие надстройки.

  3. В диалоговом окне Надстройки Office перейдите на вкладку MY ADD-INS , выберите Управление моими надстройками, а затем — Отправить мою надстройку.

    Диалоговое окно Надстройки Office с раскрывающимся списком в правом верхнем углу с надписью

  4. Найдите файл манифеста надстройки и выберите Отправить.

    Диалоговое окно отправки надстройки с кнопками

  5. Убедитесь, что надстройка установлена. Например, если у него есть команда надстройки, она должна появиться на ленте или в контекстном меню. Если это надстройка области задач, в которой нет команд надстройки, должна появиться область задач.

Примечание.

Для тестирования надстройки Office с помощью EdgeHTML (устаревшая версия Microsoft Edge) требуется дополнительный шаг настройки. В командной строке Windows выполните следующую строку: npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes. Это не обязательно, если Office использует Chromium Edge WebView2. Дополнительные сведения см. в статье Браузеры и элементы управления webview, используемые надстройками Office.

Важно!

Средство office-addin-dev-settings не поддерживается на Mac.

Загрузка неопубликоной надстройки в Microsoft 365

  1. Войдите в учетную запись Microsoft 365.

  2. Откройте средство запуска приложений в левом конце панели инструментов, выберите Excel, OneNote, PowerPoint или Word, а затем создайте документ.

  3. Выполните шаги 2–5 раздела Вручную загрузить неопубликованное приложение для Office в Интернете.

Удаление неопубликооружаемой надстройки

Чтобы удалить надстройку, загруженную в Office в Интернете, просто очистите кэш браузера. Если вы вносите изменения в манифест надстройки (например, обновляете имена файлов значков или текст команд надстройки), может потребоваться очистить кэш браузера , а затем повторно загрузить надстройку с помощью обновленного манифеста. Это позволяет Office в Интернете отображать надстройку так, как она описана в обновленном манифесте.

См. также