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

  • Статья

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

Критические изменения в Office.js

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

  • Объявления, описывающие затронутые функции и рекомендуемые изменения, можно сделать в блоге разработчиков Microsoft 365.
  • Если ваша надстройка опубликована в AppSource, с вами свяжутся с помощью предоставленных сведений.
  • По возможности с администраторами затронутых клиентов Microsoft 365 (включая арендаторы Программы разработчика Microsoft 365) будут обращаться через Центр сообщений. Администратор должен связаться с поставщиками решений надстроек, опубликованных за пределами AppSource.

Политика устаревания

API-интерфейсы или средства с лучшими альтернативами могут быть нерекомендуемы. Корпорация Майкрософт прилагает все усилия, чтобы объявить что-то как нерекомендуемое по крайней мере за 24 месяца до прекращения его использования. Кроме того, в случае с отдельными API-интерфейсами, которые являются общедоступными (GA), корпорация Майкрософт объявляет API устаревшим не менее чем за 24 месяца перед удалением ее из общедоступной версии.

Устаревание не обязательно означает, что компонент или API будут удалены и недоступны для использования разработчиками. Это показывает, что по истечении 24-месячного периода времени корпорация Майкрософт больше не будет поддерживать API или функцию.

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

Важно!

24-месячный период устаревания будет ускорен, если долгое ожидание создает угрозу безопасности для вашей надстройки или Корпорации Майкрософт.

App Assure

Служба Microsoft App Assure выполняет обещание Корпорации Майкрософт по обеспечению совместимости приложений: ваши приложения будут работать в Windows и Приложения Microsoft 365. Инженеры App Assure помогут устранить любые проблемы, которые могут возникнуть без дополнительных затрат.

Если вы столкнулись с проблемой совместимости приложений, инженеры App Assure помогут вам устранить эту проблему. Наши эксперты:

  • Помощь в устранении неполадок и выявлении первопричины.
  • Предоставьте рекомендации, которые помогут устранить проблему совместимости приложений.
  • Engage с независимыми поставщиками программного обеспечения (ISV) от вашего имени, чтобы исправить часть своего приложения, чтобы оно было функциональным в самых современных версиях наших продуктов.
  • Обратитесь к командам разработчиков продуктов Майкрософт для устранения ошибок продукта.

Чтобы узнать больше о App Assure, watch Перенос приложений в Microsoft Edge с помощью App Assure: советы и рекомендации. Чтобы отправить запрос на совместимость приложений с App Assure, заполните форму регистрации Microsoft FastTrack или отправьте сообщение электронной почты по адресу achelp@microsoft.com.

Изменения шаблонов Yeoman и веб-зависимостей

Генератор Yeoman для надстроек Office использует ряд библиотек корпорации Майкрософт и других. Эти библиотеки обновляются независимо от действий Microsoft 365. Все проекты, созданные с помощью генератора, должны обновляться при разработке, публикации и обслуживании надстройки. Следующие средства помогут убедиться, что в проекте используются безопасные версии любых зависимых библиотек.

Это руководство также относится к копиям примеров, взятых из примеров кода надстройки Office и других источников.

Текущие рекомендации

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

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

При обновлении надстройки необходимо учитывать два элемента: веб-приложение и манифест. Обновления веб-приложения не требуют никаких действий от пользователей. Эти пользователи имеют манифест только в приложении Office. Изменения манифеста требуют обновления от пользователей. Если вы опубликовали надстройку в AppSource, необходимо обновить отправку. Дополнительные сведения об этом процессе см. в статье Обновление существующего предложения.

Каждый раз, когда вы вносите изменения в манифест, необходимо повысить номер версии манифеста.

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

Взаимодействие с сообществом

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