Обновление C# пакета приложений в App Studio

Совет

Попробуйте портал разработчика: App Studio эволюционировала. Настройка, распространение и управление Teams приложениями с помощью нового портала разработчиков.

App Studio — это Teams приложение, которое можно установить из Teams магазина. Это упрощает создание и регистрацию приложения.

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

  1. Чтобы установить App Studio в Teams, выберите значок Apps в нижней части левой панели и выберите App Studio:

    Finding App Studio in the Store View
  2. Выберите плитку App Studio и установите. Установлена App Studio:

    Installing App Studio
  3. Чтобы создать пакет приложений для Teams, выберите вкладку Редактор Манифеста в App Studio:

    App Studio

    Пример поставляется с собственным манифестом и предназначен для создания пакета приложений при построении проекта. Файл manifest.json можно найти в Visual Studio в Манифесте Microsoft.Teams.Samples.HelloWorld.Web под .

    В Visual Studio файл manifest.json находится в соответствии с Манифестом Microsoft.Teams.Samples.HelloWorld.Web в . Этот шаг описывается следующим образом:

    Build the app package on .NET with Visual Studio
  4. Чтобы изменить этот пакет приложений, выберите импорт существующего приложения в редакторе Manifest:

    Importing an existing app
  5. Выберите плитку Hello World для вашего недавно импортируемого приложения:

    Newly imported app view

    На следующем изображении показан импортируемый пакет приложений в App Studio:

    Importing the app package

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

Сведения о приложении

Выберите сведения о приложении в статье Details. Выберите кнопку Создать, чтобы создать новый ID приложения.

Ваш новый ID приложения похож на 2322041b-72bf-459d-b107-f4f335bc35bd .

Сведения о приложении в правой области, включая сведения разработчика и сведения о брендинге. Эти сведения важны, если вы пишете новое приложение для распространения.

Вкладки

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

Вкладка Team

В приложении может быть только одна вкладка Team:

Adding a Teams tab

В этом примере вкладка Team отображает страницу конфигурации. Выберите символ url-адреса конфигурации Tab и выберите Изменить из выпадаемого меню. Измените URL-адрес на то, где необходимо заменить URL-адрес, используемый при https://yourteamsapp.ngrok.io/configure yourteamsapp.ngrok.io размещении приложения.

Личные вкладки

В вашем приложении может быть до 16 вкладок, включая вкладку Team.

Личные вкладки отличаются от вкладки Team. Вкладка Hello уже указана в списке личных вкладок со значением места. com.contoso.helloworld.hellotab Выберите символ url-адреса конфигурации Tab и выберите Изменить из выпадаемого меню. Появится следующее диалоговое окно:

Adding a personal tab dialog

Обновление следующих полей с URL-адресом приложения:

  • Измените поле URL-адреса контента на https://yourteamsapp.ngrok.io/hello
  • Изменение URL-адреса веб-сайта на https://yourteamsapp.ngrok.io/hello

Замените yourteamsapp.ngrok.io URL-адрес, используемый при размещении приложения.

Боты

Легко добавить функции ботов в приложение. В примере Приложения Hello World уже есть бот в качестве части примера, но его необходимо зарегистрировать в Корпорации Майкрософт:

Adding a bot

У бота, импортируемого из примера, нет связанного СД приложения. Необходимо создать новый бот, чтобы App Studio создал новый ID приложения и зарегистрировал его в Корпорации Майкрософт.

Примечание

ID приложения, созданный App Studio для бота, отличается от ID приложения, созданного для приложения. Каждому боту в приложении требуется свой собственный ID приложения.

Выполните следующие действия по настройке бота:

  1. Выберите Удаление рядом с импортируемым ботом в списке ботов. Теперь для показа не осталось ботов.

  2. Выберите Установку, чтобы отобразить диалоговое окно "Настройка бота".

    Adding a bot dialog
  3. Добавьте бот с именем бота Contoso и выберите все три флажка в области.

  4. Выберите Сохранить, чтобы выйти из диалогового окна. App Studio регистрирует бот в Microsoft и отображает новый бот в списке ботов.

  5. Теперь откройте текстовый файл в блокноте и скопируйте и вклейте в него новый бот-ИД.

  6. Нажмите кнопку Создание нового пароля и обратите внимание на пароль в том же текстовом файле, который вы отметили в коде бота App.

  7. Обновите адрес конечной точки Bot и замените URL-адресом, используемым при https://yourteamsapp.ngrok.io/api/messages yourteamsapp.ngrok.io размещении приложения.

  8. Теперь сохраните текстовый файл, так как вы должны добавить сведения из файла в ваше хост-приложение, чтобы обеспечить безопасное общение с ботом.

Расширения для система обмена сообщениями

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

Выполните следующие действия по настройке расширения обмена сообщениями:

  1. Выберите расширения обмена сообщениями в соответствии с возможностями в левом окантовке App Studio для настройки расширения обмена сообщениями:

    Adding a messaging extension

    Расширение примера обмена сообщениями перечислены в области расширения обмена сообщениями.

  2. Выберите Удаление, чтобы удалить расширение обмена сообщениями, выберите Настройка и выполните те же действия, что и для ботов. Отображается диалоговое окно расширения обмена сообщениями.

  3. Выберите вкладку Использование существующих ботов и выберите один из существующих ботов.

  4. Выберите бот, созданный из выпадаемого меню. Добавьте имя Бота и выберите Сохранить, чтобы закрыть диалоговое окно.

  5. В разделе Команда выберите Добавить. Чтобы добавить команду на основе поиска, выберите разрешить пользователям запрашивать у службы сведения и вставить их в вариант сообщения.

  6. В диалоговом окне Новая команда введите следующие значения:

    В новой команде:

    • Командный ID: Введите случайный текст
    • Название: Введите случайное название
    • Описание. Введите случайное описание

    В параметре:

    • Имя. Введите имя параметра
    • Название: Введите название карты
    • Описание. Введите описание карты
  7. После ввода сведений выберите Сохранить, чтобы закрыть диалоговое окно.

Регистрация приложения в Teams

После ввода сведений о приложении выполните следующие действия, чтобы зарегистрировать приложение в Teams:

  1. Используйте Test и распространение App Studio для установки приложения в Teams.

  2. Обновите свое хозяйное приложение с помощью ID приложения и пароля для бота. Для примера приложения используйте один и тот же код приложения и пароль для расширения бота и обмена сообщениями.

  3. Выберите Тест и раздать под Finish в левой области App Studio:

    Testing your app
  4. Чтобы загрузить приложение в Teams, выберите кнопку Установите в статье Test and Distribute:

    Adding a messaging extension dialog

    Примечание

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

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

  6. Выберите кнопку Установите в нижней части диалогового окна.

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

    The finished app

Регистрация приложения в Teams

После ввода сведений о приложении выполните следующие действия, чтобы зарегистрировать приложение в Teams:

  1. Используйте предварительный просмотр портала разработчиков для установки приложения в Teams.

    Изображение, на котором показана кнопка Preview

  2. Обновите свое хозяйное приложение с помощью ID приложения и пароля для бота. Для примера приложения используйте один и тот же код приложения и пароль для расширения бота и обмена сообщениями.

  3. Выберите Публикацию для хранения в статье Публикация в левой области портала разработчика:

    Изображение, показывающая параметр Publish в левой области

    Примечание

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

  4. Выберите Добавить, чтобы установить приложение на Teams.

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

Обновление учетных данных для вашего хозяйского приложения

Пример приложения требует, чтобы переменные среды были задатки значениям, сохраненным в текстовом файле.

  1. Откройте обозреватель решений.

    Пример репо для приложения c# Teams

  2. Откройте файл appsettings.json.

    Изображение, показывающая файл appsettings.json

  3. Обновите значение MicrosoftAppId с помощью бот-ИД, сохраненного в текстовом файле.

  4. Обнови microsoftAppPassword с помощью сохраненного пароля бота.

    Изображение с добавлением клавиш Azure

    После внесения этих изменений перестроим приложение. Если вы используете ngrok, вы можете запустить приложение локально, а если оно было у вас в Azure, передискуй приложение.

Проверьте возможности приложения в Teams

Проверка вкладки

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

Настройка вкладки приложения

  1. Перейдите к каналу в команде, где установлено пример приложения, и выберите кнопку "+", чтобы добавить новую вкладку.

  2. Выберите Hello World из списка Добавить вкладку. Отображается диалоговое окно конфигурации, которое позволяет выбрать вкладку для отображения в этом канале.

  3. Нажмите Сохранить. Вкладка Hello World загружается вкладками.

    Screenshot of configure

Проверьте бот в Teams

Теперь вы можете протестировать бот в Teams.

Тестирование бота

  • Выберите канал в команде, в которой вы зарегистрировали приложение и @your-bot-name введите. Этот тип сообщения называется @ упоминанием. Бот отвечает на любое сообщение, которое вы отправляете.

    Bot responses

Тестирование расширения обмена сообщениями

Тестирование расширения обмена сообщениями

  1. Выберите ... ниже входного окна в представлении беседы. Отображается меню с приложением "Hello World".

  2. Выберите меню, будет отображаться набор случайных текстов. Вы можете выбрать один из случайных текстов, который вставляется в беседу.

    Messaging extension menu Messaging extension result
  3. Выберите один из случайных текстов. Показана карта, отформатированная и готовая к отправке с помощью собственного сообщения.

    Messaging extension send
   
Back