Migration von Push-Benachrichtigungsfunktionen
Dieses Thema enthält Migrationsanleitungen im Bereich der Push-Benachrichtigungsfunktionen.
Wichtig
Derzeit werden nur unformatierte Pushbenachrichtigungen und App-Pushbenachrichtigungen unterstützt. Signal-Pushbenachrichtigungen und Kachel-Pushbenachrichtigungen werden nicht unterstützt.
Zusammenfassung der API- und/oder Funktionsunterschiede
Pushbenachrichtigungen können in diese vier separaten Phasen unterteilt werden.
| Phase | UWP | Windows-App-SDK |
|---|---|---|
| Identität | Partner Center (MSA) | Azure-App Registrierung (AAD) |
| Kanalanforderung | Asynchron | Asynchron Azure-App Registrierungs-ID Integrierte Wiederholungslogik (bis zu 5 Wiederholungsversuche) |
| Aktivierung | In-Process, PushTrigger*, COM-Aktivierung* | Prozessinterne COM-Aktivierung, ShellExecute |
| Senden von Pushbenachrichtigungen | Verwendet login.live.com Endpunkt zum Empfangen eines Zugriffstokens | Verwendet den https://login.microsoftonline.com/{tenantID}/oauth2/token Endpunkt für die Tokenanforderung. |
* Unterstützt für Windows 10, Version 2004 (10.0; Build 19041) und höher.
Identitätseinrichtung
Im Windows App SDK verwendet das Pushbenachrichtigungsfeature Identität aus Azure-App Registrierung (AAD), wodurch die Anforderung entfernt wird, einen Paketfamiliennamen (PACKAGE Family Name, PFN) aus Partner Center zu verwenden, um Pushbenachrichtigungen zu verwenden.
- Für eine UWP-App registrieren Und registrieren Sie die Anwendung im Windows Store Partner Center.
- Für eine Windows App SDK-App erstellen Sie ein Azure-Konto und erstellen eine Azure-App Registrierung (AAD).
Kanalanforderungen
Kanalanforderung wird asynchron behandelt und erfordert die AZURE-APP ID-GUID und azure tenantID (Sie erhalten die Azure-App ID und Mandanten-ID von einer AAD-App-Registrierung). Sie verwenden die Azure-App ID für Ihre Identität anstelle des PFN (Package Family Name), den eine UWP-App verwendet. Falls die Anforderung zu einem wiederholten Fehler führt, versucht die Benachrichtigungsplattform mehrere Wiederholungen.
Eine Windows App SDK-App kann den Status einer Kanalanforderung überprüfen.
Aktivierung
Weitere Informationen finden Sie in den Schritten zur Registrierung und Aktivierung des Windows App SDK unter "Konfigurieren Ihrer App zum Empfangen von Pushbenachrichtigungen".
Senden von Pushbenachrichtigungen
Eine Windows App SDK-App muss anstelle des MSA-Endpunkts das Zugriffstoken vom AAD-Endpunkt anfordern.
Zugriffstokenanforderung
Für eine UWP-App:
POST /accesstoken.srf HTTP/1.1
Host: login.live.com
Content-Type: application/x-www-form-urlencoded
Cookie: MSCC=73.140.231.96-US
Content-Length: 112
grant_type=client_credentials&client_id=<AppID_Here>&client_secret=<Client_Secret_Here>&scope=notify.windows.com
Für eine Windows App SDK-App (AAD-Zugriffstokenanforderung):
POST /{tenantID}/oauth2/v2.0/token Http/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 160
grant_type=client_credentials&client_id=<Azure_App_Registration_AppId_Here>&client_secret=<Azure_App_Registration_Secret_Here>&resource=https://wns.windows.com/
HTTP-Beitrag in WNS
Wenn es darum geht, eine HTTP POST-Anforderung an WNS zu senden, gibt es keine Änderungen von UWP. Das Zugriffstoken wird weiterhin im Autorisierungsheader übergeben.
POST /?token=[ChannelURI] HTTP/1.1
Host: dm3p.notify.windows.com
Content-Type: application/octet-stream
X-WNS-Type: wns/raw
Authorization: Bearer [your access token]
Content-Length: 46
{ Sync: "Hello from the Contoso App Service" }
Weitere Informationen
Windows developer