Freigeben über


Anpassen des App-Manifests für Microsoft Visual Studio

Das App-Manifest (früher Teams-App-Manifest genannt) beschreibt, wie Ihre App in Microsoft Teams integriert und von lokalen und Remoteumgebungen gemeinsam genutzt wird. Die Standardmäßige App-Manifestdatei ist in der appPackage/manifest.json Datei und den Umgebungsvariablen verfügbar, die in der env/.env.{env} Datei verfügbar sind.

Die App-Manifestdatei enthält einige Umgebungsvariablen im ${{XX_XX}} Format. Sie können ihre eigenen Umgebungsvariablen definieren und platzhalter in der manifest.json Datei hinzufügen. Im Folgenden sind die Beispiele für ENV- und .json-Dateien aufgeführt:

TEAMS_APP_DESCRIPTION=This is an amazing app
{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
    "manifestVersion": "1.16",
    "description": {
        "short": "${{TEAMS_APP_DESCRIPTION}}",
        "full": "Full description of tab0418"
    },
}

Vorschau der App-Manifestdatei

Sie können eine Vorschau der App-Manifestdatei entweder Für lokal oder Für Azure anzeigen. Führen Sie die folgenden Schritte aus, um eine Vorschau der App-Manifestdatei anzuzeigen:

  1. Wählen Sie Project>Teams Toolkit aus.

  2. Wählen Sie Teams-App-Abhängigkeiten vorbereiten oder Bereitstellen in der Cloud... aus, um Umgebungsvariablen für die lokale oder Remote-Teams-App zu generieren.

    Screenshot: App-Trigger im lokalen oder Remote-Bereich

  3. Laden Sie das Zip-App-Paket wie folgt hoch:

    1. Wählen Sie Project>Teams Toolkit>Zip App Package und dann entweder Für lokal oder Für Azure aus.

      Screenshot: ZIP-App-Paket für lokale oder Azure-Dateien

    2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf MyTeamsApp14 (in diesem Szenario lautet der Projektname MyTeamsApp14). Wechseln Sie zu Teams Toolkit>Zip App-Paket , und wählen Sie dann entweder Für lokal oder Für Azure aus.

      Screenshot: Zip-App-Paket der Lösung für lokale oder Azure-Dateien

    Teams Toolkit generiert das ZIP-App-Paket.

  4. Klicken Sie unter appPackage Ordner mit der rechten Maustaste auf die manifest.json Datei.

  5. Wählen Sie Vorschaumanifestdatei aus.

  6. Wählen Sie entweder Für lokal oder Für Azure aus.

    Screenshot: Vorschau des App-Manifests

Sie können eine Vorschau der App-Manifestdatei unter appPackage/build in Visual Studio anzeigen.

Lokale Änderungen mit dem Entwicklerportal synchronisieren

Nachdem Sie die App-Manifestdatei in Visual Studio in der Vorschau angezeigt haben, können Sie die lokalen Änderungen mit dem Entwicklerportal synchronisieren. Führen Sie die folgenden Schritte aus, um Änderungen im Entwicklerportal zu synchronisieren:

  1. Wählen Sie Projekt aus.
  2. Wählen Sie Teams Toolkit aus.
  3. Wählen Sie im Teams-Entwicklerportal Die Option Manifest aktualisieren aus.

Screenshot: Aktualisieren des App-Manifests im Teams-Entwicklerportal

Sie können die lokalen Änderungen auch über den Projektmappen-Explorer mit dem Entwicklerportal synchronisieren:

  1. Klicken Sie mit der rechten Maustaste auf MyTeamsApp14.
  2. Wählen Sie Teams Toolkit aus.
  3. Auswählen des Updatemanifests im Teams-Entwicklerportal

Screenshot: Lösungsupdate für die Teams-App

Die Änderungen werden im Entwicklerportal aktualisiert.

Tipp

Wenn Sie manuelle Updates vornehmen möchten, die im Teams-Entwicklerportal überschrieben werden können, wählen Sie im Dialogfeld Warnung die Option Überschreiben und aktualisieren aus.

Screenshot: Überschreiben der App im Teams-Entwicklerportal

Wenn Sie einen Teams-Befehlsbot mit Visual Studio erstellen, werden zwei App-IDs in Microsoft Entra ID registriert. Sie können die App-IDs im Entwicklerportal als Anwendungs-ID (Client) unter Grundlegende Informationen und vorhandene Bot-ID unter App-Features identifizieren.

Screenshot: Grundlegende Informationen zur App im Teams-Entwicklerportal

Screenshot: Überschreiben und Aktualisieren im Teams-Entwicklerportal

Siehe auch