Выберите установку для тестирования и отлаговки Microsoft Teams приложения

Microsoft Teams приложения содержат одну или несколько возможностей, а способы их запуска или даже их хозяйства отличаются. Для отладки используйте один из следующих способов:

  • Чисто локальный. Для ботов вы можете протестировать свой опыт в области Emulator. Для другого контента можно запускать локально в браузере и адресовать контент через http://localhost .
  • Локально размещено в Teams: Это включает запуск приложения локально в туннельных программ и создание пакета для загрузки в Teams. Это позволяет легко запускать и отлаговка приложения в Teams клиенте.
  • Cloud-hosted in Teams: Это действительно имитирует поддержку уровня производства для Teams приложения. Она включает в себя отправку решения на выбор внешне доступного сервера или поставщика облачных услуг и создание пакета для загрузки Teams.

Запустите опыт с собственного компьютера для чисто локального или локального Teams тестирования. При этом можно компилировать и запускать в интегрированной среде разработки и в полной мере использовать такие методы, как breakpoints и отладка шагов.

Примечание

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

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

Чисто локальный

Примечание

Локальное управление ботом не дает вам доступа к Teams приложения или Teams определенным функциям бота, как вызовы реестра и другие функции, определенные каналу. Кроме того, некоторые возможности разрешены bot Framework в бот-Emulator, которые могут не функционировать при Microsoft Teams.

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

  1. Запустите код локально.
  2. Запустите бот-Emulator и установите URL-адрес:
    • Node.js: http://localhost:3978/api/messages
    • .NET/C#: http://localhost:3979/api/messages
  3. Оставьте код приложения Майкрософт и пароль приложения Microsoft пустыми, чтобы соответствовать переменным среды по умолчанию.

Локальное хостинг

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

Хотя вы можете использовать любой инструмент по вашему выбору, мы используем и рекомендуем ngrok, который создает внешне адресируемый URL-адрес для порта, который вы открываете локально на компьютере.

Настройка ngrok в процессе подготовки к локальному Microsoft Teams приложения

  1. Перейдите в каталог, в котором ngrok.exe установлено в приложении терминала. Чтобы избежать этого шага, может потребоваться добавить его в качестве переменной пути.
  2. Запустите, например, ngrok http 3978 --host-header=localhost:3978 или замените номер порта по мере необходимости. В этом случае запускается ngrok для списка в порту, который вы указываете. Взамен он предоставляет внешне адресируемый URL-адрес, допустимый до тех пор, пока запущен ngrok.

Примечание

Если остановить и перезапустить ngrok, URL-адрес изменится.

Чтобы использовать ngrok в проекте на основе возможностей, которые вы используете, необходимо заменить все ссылки URL-адресов в коде, конфигурации и manifest.jsфайле для использования этой конечной точки URL-адреса.

Для ботов, зарегистрированных в Microsoft Bot Framework, обновим конечную точку обмена сообщениями бота, чтобы использовать эту новую конечную точку ngrok. Например, https://2d1224fb.ngrok.io/api/messages. Проверить, работает ли ngrok, можно, протестив ответ бота в окне тестового чата портала Bot Framework. Опять же, как и эмулятор, этот тест не позволяет получить доступ к Teams определенным функциям.

Примечание

Чтобы обновить конечную точку обмена сообщениями для бота, необходимо использовать bot Framework. Выберите бот в списке ботов в Bot Framework. Нет необходимости переноса бота в Microsoft Azure. Вы также можете обновить конечную точку обмена сообщениями через App Studio.

Размещение в облаке

Вы можете использовать любую внешне адресную службу для хозяйского кода разработки и производства и конечных точек HTTPS. Не ожидается, что ваши возможности будут находиться в одной службе. Мы требуем, чтобы все домены были доступны из Microsoft Teams приложений, перечисленных в validDomains объекте manifest.json в файле.

Примечание

Чтобы обеспечить безопасную среду, укажи точное имя домена и поддоменов, на которые вы ссылались, и эти домены должны быть под вашим контролем. Например, *.azurewebsites.net не рекомендуется, однако contoso.azurewebsites.net рекомендуется.

Загрузка и запуск вашего опыта

Чтобы загрузить и запустить Microsoft Teams, необходимо создать пакет и загрузить его в Teams. Подробнее:

Следующий этап