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

На этой странице — руководство по развёртыванию надстройки LawMatic в Microsoft Office методом прямой установки (sideloading): когда приложение получает файл манифеста (manifest.xml), а интерфейс надстройки загружается с сервера по URL из манифеста.

Файл для пользователей: скачать manifest.xml.

Что такое sideloading

Прямая установка (sideloading) — это способ запустить надстройку в Office вручную, передав программе XML-файл манифеста. В документации Microsoft такой сценарий часто относят к тестовым и разработческим методам, но на практике это самый прямой способ дать пользователям доступ к надстройке в обход Microsoft AppSource.

По сути sideloading не «вшивает» надстройку глубоко в систему: вы сообщаете Office, что есть описание надстройки, и Office загружает её интерфейс по указанному в манифесте адресу.

Почему пользователю достаточно одного файла

Копировать пользователю всю папку проекта с исходниками не нужно (и может только запутать): достаточно одного файла — manifest.xml.

Надстройка — это веб-приложение. HTML, JavaScript и ресурсы уже развёрнуты на сервере. В манифесте в элементах вроде SourceLocation / DefaultSettings указан HTTPS-URL этого приложения. Office читает манифест, находит ссылку и подгружает интерфейс с сервера. Локально у пользователя хранится по сути только «пусковая инструкция».

Упрощённый фрагмент структуры (пример назначения полей; ваш файл может отличаться):

<OfficeApp xsi:type="TaskPaneApp" xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
  ...
  <DefaultSettings>
    <SourceLocation DefaultValue="https://example.com/taskpane.html"/>
  </DefaultSettings>
  ...
</OfficeApp>

Требование безопасности: SourceLocation и связанные URL в манифесте должны указывать на https://. Исключение обычно делается только для локальной разработки (localhost).

Остальные файлы проекта (src, package.json, сборочные скрипты и т.д.) нужны разработке, а не конечному пользователю надстройки.

Опционально рядом с манифестом

Если у вас есть служебный скрипт вроде install-windows.ps1 для настройки каталога на Windows, его можно положить рядом с manifest.xml как помощь администратору — для работы самой надстройки он не обязателен.

Установка на Windows (через общую папку)

Основной метод для пользователей Windows.

Общая папка и манифест. Создайте на диске папку (например, C:\OfficeAddins), откройте к ней общий доступ на чтение/запись и запомните сетевой путь (например, \\DESKTOP-XXXX\OfficeAddins). Положите в эту папку файл manifest.xml — в каталоге должны быть не исходники проекта, а в том числе только этот файл манифеста.
Центр управления безопасностью. Откройте приложение Office (например, Word). Перейдите: Файл → Параметры → Центр управления безопасностью → Параметры центра управления безопасностью.
Каталог надстроек. Выберите Надёжные каталоги надстроек (Trusted Add-in Catalogs). В поле URL каталога введите сетевой путь к созданной папке, нажмите Добавить каталог и установите флажок Показывать в меню (Show in Menu).
Перезапуск. Перезапустите приложение. После этого на вкладке Главная → Надстройки → Общая папка (Shared Folder) должна появиться надстройка; её можно добавить к документу.

На Mac при необходимости можно указать тот же сетевой путь к папке на Windows: Вставка → Надстройки → Мои надстройки → Общая папка — вставьте URL и нажмите Добавить (macOS умеет обращаться к сетевым путям Windows).

Установка на macOS

Основные варианты: загрузка манифеста через интерфейс «Мои надстройки» (удобно на старых версиях Word) или копирование manifest.xml в системную папку wef (часто надёжнее на новых версиях). Если на Mac установлена виртуальная машина с Windows и настроен доступ к общей папке с манифестом — можно использовать тот же сценарий, что и для Windows (см. ниже).

1. Старые версии Word на Mac

Сохраните manifest.xml в удобное место (например, «Загрузки» или «Документы»).
Запустите Word, откройте документ. На вкладке Вставка нажмите Мои надстройки (группа «Надстройки»).
В окне «Надстройки Office» откройте вкладку Личные надстройки. Внизу выберите Загрузить мою надстройку (Upload My Add-in).
В Finder укажите сохранённый manifest.xml. При предупреждении безопасности (надстройка не из магазина) подтвердите Принять / Доверять. Надстройка останется в списке и после перезапуска Word.

Нюансы для Mac

Постоянство: надстройка, добавленная таким способом, обычно не пропадает после закрытия Word.
Обновление манифеста: при новой версии манифеста повторите шаги. Старую запись можно удалить в «Мои надстройки» через меню ⋯ → Удалить.
Сервер: интерфейс по-прежнему загружается с сервера; манифест только задаёт адрес.

2. Новые версии Word на Mac (папка `wef`)

Полностью закройте Word (⌘Q).
В Finder: меню Переход → Переход к папке… (⇧⌘G). Вставьте путь, подставив вместо <username> имя вашей учётной записи macOS:

/Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

Пример: /Users/ivan/Library/Containers/com.microsoft.Word/Data/Documents/wef

Ниже — скриншоты этапов в Finder (нажмите на изображение, чтобы открыть в полном размере).

Finder — меню Переход → Переход к папке… (или ⇧⌘G).

Окно «Переход к папке» с корректно введённым путём к каталогу wef Microsoft Word.

Если папки wef нет — создайте её (⇧⌘N, имя wef). Скопируйте сюда manifest.xml.

Создайте каталог wef, если его ещё нет.

Файл manifest.xml в каталоге wef.

Запустите Word. На вкладке Главная нажмите Надстройки и выберите надстройку в списке.

При первом запуске Word может показать подсказку или предупреждение безопасности — для sideloading без подписи это ожидаемо; подтвердите Понятно или доверие, если согласны продолжить.

Как это выглядит в Word

Word до подключения надстройки (кнопки LawMatic на ленте ещё нет).

После установки на ленту выводятся кнопки надстройки.

Надстройка открыта и работает в панели задач.

Для Excel и PowerPoint путь к каталогу wef тот же по смыслу, но меняется идентификатор контейнера приложения:

Приложение	Путь к папке `wef`
Word	`.../Containers/com.microsoft.Word/Data/Documents/wef`
Excel	`.../Containers/com.microsoft.Excel/Data/Documents/wef`
PowerPoint	`.../Containers/com.microsoft.PowerPoint/Data/Documents/wef`

Если на «Вставке» пропал нужный пункт

Microsoft периодически меняет ленту: у части пользователей «Мои надстройки» на Mac недоступны или перекрыты магазином. Тогда используйте «Надстройки» на вкладке «Главная» или ручное копирование в wef. Альтернатива — Word / Excel / PowerPoint в браузере: Вставка → Надстройки → Мои надстройки → Отправить надстройку — часто стабильнее для разовой загрузки манифеста.

3. Mac и виртуальная машина с Windows

Если манифест лежит в расшаренной папке внутри гостевой Windows (Parallels, VMware и т.д.) и с macOS виден сетевой путь к этой папке:

На стороне Windows создайте каталог с общим доступом, положите туда manifest.xml, запомните UNC-путь (\\ИМЯ-ПК\ИмяОбщейПапки).
Убедитесь, что с macOS этот путь открывается в сети (как настроена ВМ — зависит от конфигурации).
На Mac: Вставка → Надстройки → Мои надстройки → Общая папка — вставьте сетевой путь и нажмите Добавить.

В браузере (Office на веб)

Быстрый кроссплатформенный вариант. Учтите: надстройка привязана к сессии браузера на этой машине.

Откройте документ в Office Online (Word, Excel или PowerPoint в браузере).
Вставка → Надстройки. В окне выберите Мои надстройки → Отправить надстройку (Upload My Add-in).
Укажите файл manifest.xml с локального диска (Обзор / Browse).

На iPad

Подключите iPad к компьютеру; в iTunes или Finder (macOS Catalina и новее) откройте общий доступ к файлам для приложения Word или Excel.
Перетащите manifest.xml в файлы приложения.
На iPad откройте документ, раздел Надстройки — надстройка должна появиться в списке.

Ограничения sideloading

Это не «установка в систему» в классическом смысле: метод рассчитан на ручное подключение; массовое распространение через магазин им не заменить.
Массовое обновление манифеста всем пользователям может потребовать повторения шагов; изменение ленты (новые команды) часто требует переустановки надстройки у клиента.
Сценарий «общая папка» как доверенный каталог для манифестов официально ориентирован на Windows; Mac без доступа к такому пути может не увидеть каталог так же, как Windows-клиент.
Для корректной загрузки веб-контента может понадобиться разрешение в настройках Office на подключение к веб-службам Microsoft (формулировка зависит от версии).

Автоматизация (для администраторов)

Файл реестра (.reg): можно задать доверенный каталог надстроек без ручного обхода всех окон — файл импортируется двойным щелчком (готовьте и тестируйте под свою политику безопасности).
PowerShell в Microsoft 365: для централизованного развёртывания смотрите официальные сценарии с командлетами вроде New-OrganizationAddIn (актуальные имена и параметры — в документации Microsoft для вашей среды).

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

Обновление состоит из двух независимых частей.

Веб-приложение

Код интерфейса (HTML, JS) загружается с сервера при открытии панели задач. Изменения на сервере пользователи видят после обновления панели или перезапуска приложения — отдельно манифест для этого не всегда нужен.

Манифест

Файл manifest.xml Office кэширует. Если вы изменили содержимое манифеста (версия, разрешения, иконки, команды на ленте и т.д.), недостаточно обновить только сайт:

Положите новый manifest.xml в ту же расшаренную папку (или замените файл в wef на Mac).
Очистите кеш Office для веб-надстроек: в Word: Файл → Параметры → Центр управления безопасностью → Параметры центра управления безопасностью → Надёжные каталоги надстроек — включите «При следующем запуске очистить все ранее запущенные веб-надстройки» (формулировка может слегка отличаться).
Перезапустите Office. При необходимости снова добавьте надстройку к документу.

Уведомление о версии: в самой веб-надстройке можно сравнивать версию с сервера с ожидаемой и показывать сообщение вроде «Скачайте новый manifest.xml и перезапустите Word» — это не заменяет замену файла, но снижает путаницу.

Кратко: изменения только на сервере подтягиваются сами; изменения в манифесте требуют замены файла и сброса кеша.

Подпись манифеста

Поведение Office зависит от цифровой подписи XML:

Без подписи — для теста на своей машине часто достаточно; на другом ПК возможны предупреждения о неизвестном издателе. В организации политики безопасности могут блокировать запуск.
Самоподписанный сертификат — предупреждения могут оставаться, пока корневой сертификат не добавлен в доверенные на устройстве.
Сертификат от публичного УЦ — устраняет предупреждения для пользователей при соблюдении требований кода подписи.

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

← Обзор раздела · Документация LawMatic (главная)