Загрузка неопубликованных надстроек Office в Office в Интернете
Загружая неопубликованную надстройку, вы можете установить надстройку, не помещая ее в каталог надстроек. Это полезно при тестировании и разработке надстройки, так как вы можете увидеть, как она будет отображаться и работать.
Когда вы загружаете неопубликованную надстройку в Интернете, манифест надстройки сохраняется в локальном хранилище браузера, поэтому при очистке кэша браузера или переключении на другой браузер необходимо снова загрузить неопубликованную надстройку.
Действия по загрузке неопубликованных приложений в Интернете зависят от следующих факторов.
- Ведущее приложение (например, Excel, Word, Outlook)
- Какое средство создало проект надстройки (например, Visual Studio, генератор Yeoman для надстроек Office или ни один)
- Загружаете ли вы неопубликованные данные в Office в Интернете с учетной записью Майкрософт или учетной записью в клиенте Microsoft 365
В следующем списке перейдите к разделу или статье, которые соответствуют вашему сценарию. Обратите внимание, что первый сценарий в списке относится к надстройкам Outlook. Остальные сценарии применяются к надстройкам, отличным от Outlook.
Если вы загружаете неопубликованную надстройку Outlook, см. статью Загрузка неопубликованных надстроек Outlook для тестирования.
Если вы создали надстройку с помощью генератора Yeoman для надстроек Office, см. раздел Загрузка надстройки, созданной Yeoman, в Office в Интернете.
Если вы создали надстройку с помощью Visual Studio, см. раздел Загрузка неопубликованных надстроек в Интернете при использовании Visual Studio.
Для всех остальных случаев см. один из следующих разделов.
- Если вы загружаете неопубликованное приложение в Office в Интернете с учетной записью Майкрософт, см. раздел Загрузка надстройки вручную в Office в Интернете.
- Если вы загружаете неопубликованный Office в Интернете с учетной записью в клиенте Microsoft 365, см. раздел Загрузка неопубликованных надстроек в Microsoft 365.
Загрузка надстройки, созданной Yeoman, в Office в Интернете
Этот процесс поддерживается только для Excel, OneNote, PowerPoint и Word. В этом примере проекта предполагается, что вы используете проект, созданный с помощью генератора Yeoman для надстроек Office.
Откройте Office в Интернете или OneDrive. С помощью параметра Создать создайте документ в Excel, OneNote, PowerPoint или Word. В этом новом документе выберите Общий доступ, Копировать ссылку и скопируйте URL-адрес.
Откройте командную строку от имени администратора. В командной строке, начиная с корневого каталога проекта, выполните следующую команду. Замените "{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 в Интернете.
При первом использовании этого метода для загрузки неопубликованного надстройки в Интернете появится диалоговое окно с запросом на включение режима разработчика. Установите флажок Включить режим разработчика сейчас и нажмите кнопку ОК.
Появится второе диалоговое окно с запросом на регистрацию манифеста надстройки Office с компьютера. Выберите Да.
Надстройка установлена. Если у него есть команда надстройки, она должна появиться на ленте или в контекстном меню. Если это надстройка области задач без команд надстройки, должна появиться область задач.
Загрузка неопубликованных надстроек в Интернете при использовании Visual Studio
Если вы используете Visual Studio для разработки надстройки, нажмите клавишу F5 , чтобы открыть документ Office в классическом office , создать пустой документ и загрузить неопубликованную надстройку. Если вы хотите загрузить неопубликованное Office в Интернете, процесс загрузки неопубликованных приложений аналогичен загрузке неопубликованных приложений вручную в Интернет. Единственное отличие заключается в том, что необходимо обновить значение элемента SourceURL и, возможно, других элементов в манифесте, чтобы включить полный URL-адрес, где развернута надстройка.
В Visual Studio выберите Вид>окна свойств.
В обозревателе решений выберите веб-проект. При этом в окне Свойства отображаются свойства проекта.
В окне "Свойства" скопируйте URL-адрес SSL.
В проекте надстройки откройте XML-файл манифеста. Обязательно редактировать исходный XML-код. Для некоторых типов проектов Visual Studio откроет визуальное представление XML, которое не будет работать на следующем шаге.
Найдите и замените все экземпляры ~remoteAppUrl/ только что скопированным URL-адресом SSL. Вы увидите несколько замен в зависимости от типа проекта, а новые URL-адреса будут выглядеть примерно так:
https://localhost:44300/Home.html
.Сохраните XML-файл.
В Обозреватель решений откройте контекстное меню веб-проекта (например, щелкнув его правой кнопкой мыши), а затем выберите ОтладкаЗапуск нового экземпляра>. При этом веб-проект запускается без запуска Office.
С Office в Интернете загрузите неопубликованную надстройку, выполнив действия, описанные в разделе Загрузка неопубликованного надстройки вручную в Office в Интернете.
Загрузка неопубликованных приложений вручную в Office в Интернете
Этот метод не использует командную строку и может выполняться с помощью команд только в ведущем приложении (например, Excel).
Откройте Office в Интернете. Откройте документ в Excel, OneNote, PowerPoint или Word.
Выберите Главная>надстройки, а затем — Другие надстройки.
В диалоговом окне Надстройки Office перейдите на вкладку MY ADD-INS , выберите Управление моими надстройками, а затем — Отправить мою надстройку.
Найдите файл манифеста надстройки и выберите Отправить.
Убедитесь, что надстройка установлена. Например, если у него есть команда надстройки, она должна появиться на ленте или в контекстном меню. Если это надстройка области задач, в которой нет команд надстройки, должна появиться область задач.
Примечание.
Для тестирования надстройки 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
Войдите в учетную запись Microsoft 365.
Откройте средство запуска приложений в левом конце панели инструментов, выберите Excel, OneNote, PowerPoint или Word, а затем создайте документ.
Выполните шаги 2–5 раздела Вручную загрузить неопубликованное приложение для Office в Интернете.
Удаление неопубликооружаемой надстройки
Если вы выполнили npm start
команду и надстройка была автоматически загружена неопубликованным приложением, выполните команду npm stop
, когда будете готовы остановить сервер разработки и удалить надстройку.
В противном случае, чтобы удалить надстройку, загруженную в Office в Интернете, просто очистите кэш браузера. Если вы вносите изменения в манифест надстройки (например, обновляете имена файлов значков или текст команд надстройки), может потребоваться очистить кэш браузера, а затем повторно загрузить надстройку с помощью обновленного манифеста. Это позволяет Office в Интернете отображать надстройку так, как она описана в обновленном манифесте.
См. также
Office Add-ins