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

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

  • Исключительно локально. Для ботов можно протестировать пользовательское взаимодействие в службе эмулятора ботов. Другие типы программ можно запускать локально в браузере и адресовать содержимое с помощью http://localhost.
  • Локальное размещение в Teams. Это подразумевает запуск приложения локально с помощью туннелирующего программного обеспечения и создание пакета для отправки в Teams. Это позволяет легко запускать и отлаживать приложение в клиенте Teams.
  • Размещение в облаке в Teams. Этот сценарий обеспечивает полную имитацию поддержки приложения Teams в производственной среде. Он включает отправку решения на выбранный внешний сервер или поставщик облачных служб и создание пакета для отправки в Teams.

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

Примечание.

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

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

Исключительно локальное

Примечание.

Локальный запуск бота не предоставляет доступ к функциям Teams приложения или функциям бота, специфичным для Teams, таким как вызовы списков личного состава и другие функциональные возможности, относящиеся к каналам. Кроме того, в Bot Framework в эмуляторе бота разрешены некоторые возможности, которые могут не работать при запуске в Teams.

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

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

Локальное размещение

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

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

Чтобы настроить ngrok в процессе подготовки к локальному выполнению приложения Teams, выполните следующие действия.

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

Примечание.

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

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

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

Примечание.

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

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

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

Примечание.

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

Загрузка и запуск интерфейса

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

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

Дополнительные ресурсы