Ankündigung von .NET SDK Version 5.0.0

Ich freue mich, Ihnen die Veröffentlichung unseres neuen .NET 5.0.0 SDK. Dies ist mein erstes größeres Release, seit ich letztes Jahr zum Platform & Developer Experience Team bei Vonage gestoßen bin, und ich freue mich, die Neuerungen mit Ihnen zu teilen.

Neue Funktionen

Wir haben dem .NET SDK einige neue Funktionen hinzugefügt, hier ist eine Aufzählung davon.

Neu aufgebautes SDK um .NET-Konventionen herum

Ältere Versionen des SDKs fühlten sich nicht sehr ".NET" an, diese Version behebt das.

• Wir haben alle API-Aufrufe hinter Schnittstellen abstrahiert, die eine einfache Substitution über Dependency Injection für Ihre Tests ermöglichen. Zum Beispiel wird die SMS-Klasse des Legacy-SDKs durch die ISmsClient Schnittstelle ersetzt, die Sie durchsprechen oder selbst ersetzen können.

• Alle neuen Strukturen und APIs sind nun mit den .NET-Namenskonventionen konform. Außerdem haben wir viele neue Enums eingeführt, um einige offene Stringfelder zu entfernen. Wir haben die alten Strukturen beibehalten, sie aber als veraltet gekennzeichnet, um Sie daran zu erinnern, die neueste Version zu aktualisieren, da dies das Upgrade erleichtert.

Neue Protokollierungsmethodik

Das SDK wurde um eine neue Art der Protokollierung ergänzt, die auf Microsoft.Erweiterungen.Protokollierung. So können Sie die Protokollierung des SDK so konfigurieren, dass das von Ihnen gewünschte Protokollierungsformat verwendet wird; Sie können es so kompatibel zu Ihren eigenen Protokollen machen, wie Sie möchten, und es besteht keine Notwendigkeit, die Ausgaben unseres SDKs in Ihren Protokolldateien zu protokollieren.

Siehe meine Erläuterung wie dies aufgebaut ist und wie Sie mit Ihren eigenen Protokollen arbeiten können!

Zusammenfassende Dokumentationsdatei hinzugefügt

Das SDK wird jetzt mit einer zusammenfassenden Dokumentationsdatei geliefert, die es Ihnen erleichtert, die Erstellung Ihrer Applications zu planen.

Neue Methodik der Fehlerbehandlung

Alle API-Aufrufe lösen eine Ausnahme aus, die eine bestmögliche Beschreibung des Fehlers enthält, wenn sie auf einen Fehler stoßen. Dazu gehören alle 4xx- und 5xx-Antworten sowie Fehler aus dem SMS, Numbers, Numbers Einsichtund Verify APIs, die mit einer 200 OK-Antwort und einem Fehlercode reagieren können. Alle diese Ausnahmen sind vom Typ NexmoException (SubTypes NexmoSmsResponseException, NexmoNumberInsightResponseException, NexmoNumberResponseException, NexmoVerifyResponseException) oder NexmoHttpRequestException.

Es gibt ähnliche Fehler, die auch für die Legacy-APIs ausgegeben werden.

Unter der Haube

Wir haben auch einige bedeutende Verbesserungen unter der Haube vorgenommen, die für die Interaktion mit der API weniger relevant sind, aber dennoch interessant sein könnten.

Umgestaltete interne Anforderungsmethoden

Wir haben alle internen Methoden umstrukturiert ApiRequest Methoden überarbeitet, um sie benutzerfreundlicher und allgemeiner zu gestalten. Sie können einen Blick darauf werfen hier.

Hinweis: Diese Methoden werden nicht als Teil der öffentlichen API des SDK betrachtet und können ohne vorherige Ankündigung geändert werden.

Einheitliche Tests

Wir haben eine ganz neue Reihe von Unit-Tests hinzugefügt, um zu verhindern, dass Dinge auf dem Weg nach draußen kaputt gehen. Die Abdeckung der Unit-Tests stieg von 33 % in 4.4.0 auf 87 % in 5.0. Praktisch alles, was nicht getestet wird, ist entweder Legacy oder eine Datei eines Drittanbieters, die wir in das SDK integriert haben.

Wechselnde Änderungen

Wir haben unser Bestes getan, um sicherzustellen, dass der Upgrade-Pfad zu 5.0 so nahtlos wie möglich sein wird.

Die neuen Strukturen sollten keine Auswirkungen auf die derzeitigen Benutzer des SDK haben, obwohl ich jeden ermutigen möchte, die Veralterungswarnungen zu beachten. Abgesehen davon gibt es eine Reihe von Änderungen zwischen 4.x und 5.x, die Sie beachten sollten.

• Wir haben LibLog entfernt, so dass die Protokolle ohne Zutun des Entwicklers nicht mehr mit den Protokollen des Entwicklers vermischt werden können.

• Neue Ausnahmen werden ausgelöst, wenn bei einem API-Aufruf ein Fehler auftritt, einschließlich 200 Antworten mit Fehlercodes.

Es wird noch mehr kommen

Diese neue Bibliothek ist eine große Veränderung für das .NET SDK, aber sie ist erst der Anfang. Wir haben noch viel mehr vor und ich freue mich darauf, in Zukunft mehr mit Ihnen zu teilen!

Wenn Sie bis dahin noch Fragen haben, finden Sie uns auf unserem Community-Slack.

Ressourcen

• Sie finden unser NuGet-Paket hier

• Unser SDK wird gepflegt in GitHubSie können es gerne erkunden, ein Problem öffnen, wenn Sie auf ein Problem stoßen, oder vielleicht sogar etwas dazu beitragen!