Skip to content

airmelt/fx-example

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Overview

At current stage, Teams App has a wealth of features and many applications. At present, however, only the web documents provide information on these features. This way has a weak direct-viewing display effect. Therefore, this Teams App to show Teams Extension (Teams Toolkit) features. The goal is to allow all the developers, especially rookies, of Teams App to easily access it and get a better development experience.

What is Teams app capabilities

Features

  • Simple, intuitive interface for all developers for developers with limited acknowledge and experience on Teams App to be as simple and intuitive as possible.
  • Efficient – since reading documents and finding APIs on webs is time consuming, this App had to be efficient with examples such as getting the user information, uploading/downloading files and showing UI components.
  • Cross platform[optional] – the App be available across 2 platforms: Teams Client and Mobile Teams App. The app will be designed adaptively to achieve the same experience both on computers and mobile phones.

Structure

Structure

App

Teams Toolkit

This part shows Teams Extension (Teams Toolkit) features, there are GIF pictures to display almost all the features giving tips:

  • GETTING STARTED: information about how to create an App by using a sample
  • PROJECT: includes Create New Project, Add Capabilities, Deploy to the Cloud and so on. You can create your own App and publish it on the Azure or Teams just in Visual Studio Code.

Teams Dev

This part shows how to use Teams App ability step by step and Microsoft Graph API in Teams, there are GIF pictures to display some features and giving tips on @microsoft/teams-js and @microsoft/teamsfx SDK:

  • Tab: includes Deeplink/Mobile tab[optional]/Static Tab - README
  • Bot: includes Adaptive Card - README
  • Messaging Extension: includes Action Commands/Search Commands/Link Unfurling

UI

@fluentui/react-northstar - A themable React component library.

The UI components are derived from @fluentui/react-northstar and are divided into 3 parts:

  • Overall: includes theming and layout aspects components
  • Component: logically divided into multiple parts instead of sorting in alphabetical order
  • Prototypes: includes complex or combined components

Prerequisites

Enable Sideloading

  1. Sign in to Microsoft 365 admin center
  2. select Show all > Teams

M365 Teams

  1. Navigate to Teams apps > Setup Policies > Global.

Setup

  1. Toggle Upload custom apps to the On position.
  2. Select Save. Your test tenant can permit custom app sideloading.

Getting Started

To use the app in Teams, download the release zip file first.

  1. Upload this app to your Teams

upload to Teams

  • 1.1 Press ... and choose More app Or Press App icon in the left bottom
  • 1.2 Press Upload a custom app
  1. Upload appPackage.zip
  2. Sideload App by directly press Add (recommended) or add this app to your channel

Sideload

  1. Enjoy exploring the App!
  • 4.1 Sideload:

Sideload

  • 4.2 channel:

channel

Debug/Run project

  • Debug: Open Debug View (Ctrl+Shift+D), select Debug Remote (Edge), then Click start Debugging or Press F5
  • Run: Open Debug View (Ctrl+Shift+D), select Launch Remote (Edge), then Click start Debugging or Press F5

Debug/Run project

Collaboration

Attention: The M365 Account of Collaborators shoule be the same tenant with the owner of the App.

  1. Sign in to Microsoft 365 admin center
  2. select Users > Active users, add user to your tenant

Admin Center add user

  1. Sign in to Azure Portal
  2. Search for Users, add New user or Invite user

Azure Portal add user

  1. Choose to Create user or Invite user

Azure Portal invite user

  1. Accept the invitation in your mailbox

Accept the invitation

Review permissions

  1. Select Azure Active Directory > App registrations > Your App > Owners, then add owner

add Owners

select Owners

  1. Sign in to Developer Portal
  2. Choose app, and add owners of your app

choose app

add app Owners

search app Owners

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published