Создание приложений с помощью набора инструментов Teams и Visual StudioBuild apps with the Teams Toolkit and Visual Studio

Набор средств Microsoft Teams позволяет создавать пользовательские приложения Teams непосредственно в интегрированной среде разработки Visual Studio (IDE).The Microsoft Teams Toolkit enables you to create custom Teams apps directly within the Visual Studio integrated development environment (IDE). Набор средств Microsoft Teams поможет вам выполнить все необходимые действия для создания, отладки и запуска приложения Teams.The Microsoft Teams toolkit guides you through the process and provides everything you need to build, debug, and launch your Teams app.

Необходимые компонентыPrerequisites

  1. Включение предварительной версии для разработчиковEnable developer preview

  2. Убедитесь, что в экземпляр Visual Studio добавлен модуль ASP.NET и веб-разработки .Make sure that the ASP.NET and web development module has been added to your Visual Studio instance. Вы можете проверить их, выполнив действия, описанные в разделе изменение Visual Studio, добавив или удалив рабочие нагрузки и документацию по компонентам.You can check by following the steps in the Modify Visual Studio by adding or removing workloads and component documentation.

модуль Visual Studio asp.net

  1. Если вы хотите протестировать приложение, развертывая его из Visual Studio, вам потребуется установить службы IIS (Internet Information Services) в среде разработки.If you would like test your app by deploy it from Visual Studio, you'll need to have IIS (Internet Information Services) installed in your development environment. Visual Studio не включает IIS и не включается в конфигурацию Windows 10, Windows 8 или Windows 7 по умолчанию; Однако последнюю версию можно скачать в центре загрузки Майкрософт.Visual Studio does not include IIS and it isn't included in the default Windows 10, Windows 8, or Windows 7 configuration; however, you can download the latest version from the Microsoft download center.

Представление страницы скачивания IIS

Установка набора инструментов TeamsInstall the Teams Toolkit

Набор средств Microsoft Teams для Visual Studio доступен для загрузки из Visual Studio Marketplace или непосредственно из меню расширения в Visual Studio.The Microsoft Teams Toolkit for Visual Studio is available for download from the Visual Studio Marketplace or directly from the Extensions menu within Visual Studio.

Использование набора средствUsing the toolkit

Настройка нового проекта TeamsSet up a new Teams project

  1. Выберите создать новый проект.Select Create a new project.
  2. Выберите приложение Microsoft Teams и нажмите кнопку Далее.Choose Microsoft Teams App and select Next.
  3. Вы будете приступать к экрану Настройка нового проекта , где можно выбрать имя проекта, Расположение и имя решения.You will arrive at the Configure your new project screen where you can choose the Project name, Location, and Solution name.
  4. Установите флажок пометить решение и проект в одном и том же каталоге.Check the box labeled Place solution and project in the same directory.
  5. Всплывающее окно с подписью добавить возможности позволит выбрать одну или несколько возможностей для настройки проекта.A pop-up window labeled Add Capabilities will allow you to choose one or more capabilities for your project setup.
  6. Нажмите кнопку Далее , чтобы завершить процесс настройки.Select the Next button to complete the configuration process.
  7. Всплывающее окно с пометкой добавить возможности позволит выбрать свойства для каждой выбранной возможности.A pop-up window labeled Add Capabilities will allow you to choose the properties for each selected capability.
  8. Нажмите кнопку Готово , и вы будете намерены на начальной странице набора инструментов Microsoft Teams .Select Finish and you will land on the Microsoft Teams Toolkit landing page.

Настройка приложенияConfigure your app

В основном приложение Teams поработает с тремя компонентами:At its core, the Teams app embraces three components:

  1. Клиент Microsoft Teams (веб-сайт, Настольный компьютер или мобильное устройство), на котором пользователи взаимодействуют с вашим приложением.The Microsoft Teams client (web, desktop or mobile) where users interact with your app.
  2. Сервер, который отвечает на запросы для контента, который будет отображаться в Teams, например, контент вкладки HTML или адаптивной карточки Bot.A server that responds to requests for content that will be displayed in Teams, e.g., HTML tab content or a bot adaptive card .
  3. Пакет приложения Teams состоит из трех файлов:A Teams app package consisting of three files:
  • manifest.jsнаThe manifest.json
  • Значок цвета приложения для отображения в каталоге приложений "общедоступный" или "Организация"A color icon for your app to display in the public or organization app catalog
  • Значок структуры для отображения на панели активности Teams.An outline icon for display on the Teams activity bar.

При установке приложения клиент Teams анализирует файл манифеста, чтобы определить необходимые сведения, такие как имя вашего приложения и URL-адрес, по которому расположены службы.When an app is installed, the Teams client parses the manifest file to determine needed information like the name of your app and the URL where the services are located.

Примечание

Если вы еще не сделали этого, вам потребуется войти в систему Microsoft 365 или учетную запись, чтобы продолжить процесс разработки.If you haven't done so already, you will need to sign in to your Microsoft 365 or account to continue with the development process.

Если у вас нет учетной записи Microsoft 365, вы можете подписаться на подписку на программу для разработчиков microsoft 365 .If you don't have a Microsoft 365 account, you can sign up for a Microsoft 365 Developer Program subscription. Он освободится на 90 дней и будет обновляться до тех пор, пока вы его используете для разработки действий.It's free for 90 days and will continually renew as long as you're using it for development activity. Если у вас есть подписка на Visual Studio Enterprise или Professional , обе программы включают бесплатную подпискуна Microsoft 365 для разработчиков, действующую в течение всего срока действия вашей подписки на Visual Studio.If you have a Visual Studio Enterprise or Professional subscription, both programs include a free Microsoft 365 developer subscription, active for the life of your Visual Studio subscription. Ознакомьтесь со статьей Настройка подписки на Microsoft 365 для разработчиков.See Set up a Microsoft 365 developer subscription.

Этапы конфигурацииConfiguration steps

  1. Чтобы настроить приложение, на начальной странице набора инструментов Microsoft Teams выберите изменить пакет приложения .To configure your app, on the Microsoft Teams Toolkit landing page, select Edit app package .
  2. В раскрывающемся меню Мои среды выберите пункт Разработка.From the My Environments drop-down menu, select development.
  3. На странице сведения о приложении вы можете изменить поля свойств приложения.You will land on the App details page where you can edit your app's property fields.
  4. Изменение полей на странице "сведения о приложении" обновляет содержимое manifest.jsв файле, который в конечном итоге будет поставляться в составе пакета приложения.Editing the fields in the App details page updates the contents of the manifest.json file that will ultimately ship as part of the app package. ПодробнееLearn more

Упаковка приложенияPackage your app

Изменение страницы сведений о приложении или обновление манифеста или файлов env в папке публикации приложения автоматически создаст файл Development.zip .Modifying the app details page or updating the manifest, or .env files in your app's .publish folder will automatically generate your Development.zip file. Файл Development.zip состоит из трех обязательных файлов: manifest.jsдля и двух файлов значков.The Development.zip file includes three required files — the manifest.json and two icon files.

Установка и запуск приложения на локальном компьютереInstall and run your app locally

  1. В раскрывающемся меню конфигурации решения выберите команду развернуть.From the Solution Configurations dropdown menu, select Deploy.

Меню конфигураций решения

  1. Нажмите кнопку ISS Express + Teams .Select the ISS Express + Teams button.

  2. Запускаются Teams, а диалоговое окно установки приложения должно отображаться в клиенте Teams.Teams will launch and the app installation dialogue should appear in the Teams client.

Проверка приложенияValidate your app

Страница проверки позволяет проверить пакет приложения перед отправкой приложения в AppSource.The Validate page allows you to check your app package before submitting your app to AppSource. Просто отправьте пакет манифеста, и средство проверки проверит ваше приложение на соответствие всем тестовым случаям, связанным с манифестом.Simply upload the manifest package and the validation tool will check your app against all manifest related test cases. Для каждого неудачных тестов в описании представлена ссылка на документацию, которая поможет исправить ошибку.For each failed tests, the description provides a documentation link to help you fix the error. Для тестов, которые трудно автоматизировать, Предварительный контрольный список включает 7 наиболее распространенных тестовых случаев, а также ссылки на полный контрольный список отправки.For the tests that are hard to automate, the Preliminary checklist details 7 of the most common failed test cases as well as link to a complete submission checklist.

Публикация приложения в TeamsPublish your app to Teams

✔ На домашней странице проекта вы можете отправить свое приложение в группу, отправить свое приложение в пользовательскую магазин приложений для пользователей в вашей организации или отправить свое приложение в источник приложений для всех пользователей Teams.✔ On your project home page, you can upload your app to a team, submit your app to your company custom app store for users in your organization, or submit your app to App Source for all Teams users.

✔ ИТ ИТ ИТ, просматривая эти отправки.✔ Your IT admin will review these submissions.

✔ Вы можете вернуться на страницу публикации , чтобы проверить состояние отправки и узнать, было ли ваше приложение утверждено или отклонено вашим ИТ-администратором. Кроме того, здесь вы будете передавать обновления в свое приложение или отменять все активные в данный момент отправки.✔ You can return to the Publish page to check on your submission status and learn if your app was approved or rejected by your IT admin. This is also where you'll come to submit updates to your app or cancel any currently active submissions.