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

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

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

Sideloading меняет между хост-приложениями (например, Excel).

Примечание

Sideloading, как описано в этой статье, поддерживается в Excel, OneNote, PowerPoint и Word. Соответствующие действия касательно надстройки Outlook приведены в статье Загрузка неопубликованных надстроек Outlook для тестирования.

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

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

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

  2. В корневом каталоге файлов проекта yo office откройте файл package.json. В разделе config этого файла создайте "document" свойство. Вклеить URL-адрес, скопированные в качестве значения "document" для свойства. Например, ваша будет выглядеть так:

      "config": {
        "document": "<YOUR URL>",
        ...
      }
    

    Совет

    Если вы создаете надстройку, не использующую генератор Yeoman, вы можете добавить параметры запроса в URL-адрес документа, применив следующее к существующему URL-адресу.

    • Порт сервера разработчиков, например &wdaddindevserverport=3000 .
    • Имя файла манифеста, например &wdaddinmanifestfile=manifest1.xml .
    • GuID манифеста, например &wdaddinmanifestguid=05c2e1c9-3e1d-406e-9a91-e9ac64854143 .

    Если вы используете генератор Yeoman, добавление этой информации не требуется, так как приложение yeoman tooling автоматически добавляет эту информацию. Обратите внимание, что в обоих случаях можно загружать манифесты только из localhost.

  3. В командной строке, начиная с корневого каталога проекта, запустите следующую команду. Замените "{url}" URL-адресом документа Office в OneDrive или SharePoint библиотеки, на которую у вас есть разрешения.

    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

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

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

  5. Вы увидите второй диалоговое окно с вопросом, хотите ли вы зарегистрировать манифест Office надстройки с компьютера. Вы должны выбрать Да.

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

Sideload an Office in Office в Интернете вручную

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

  1. Откройте Office в Интернете. Откройте документ в Excel, Word или PowerPoint. На вкладке Вставка на ленте в разделе Надстройки выберите Office надстройки.

  2. В диалоговом Office надстройки выберите вкладку MY ADD-INS, выберите Управление надстройками, а затем Upload надстройки.

    Диалог Office надстройки с отбрасывом в верхнем правом считыве "Управление надстройки" и выпадаемой ниже с опцией "Upload моя надстройка".

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

    Диалоговое окно отправки надстройки с кнопками "Обзор", "Отправить" и "Отмена"

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

Примечание

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

Важно!

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

Sideload an Office add-in

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

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

  3. Действия 3–6 совпадают с действиями в предыдущем разделе Загрузка неопубликованной надстройки Office в Office в Интернете.

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

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

Примечание

Хотя неопубликованные надстройки можно загружать из Visual Studio в Office в Интернете, их невозможно отлаживать из Visual Studio. Для этого вам потребуются средства отладки браузера. Дополнительные сведения см. в статье Отладка надстроек в Office в Интернете.

  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 в Интернете.

Удаление боковой надстройки

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

См. также