https://d226lax1qjow5r.cloudfront.net/blog/blogposts/announcing-net-sdk-version-5-0-0/Blog_SDK-Updates_1200x600.png

.NET SDKバージョン5.0.0の発表

最終更新日 May 4, 2021

所要時間:1 分

新しい .NET 5.0.0 SDK.これは、昨年Vonageのプラットフォーム&デベロッパー・エクスペリエンス・チームに参加して以来、初めてのメジャー・リリースです。

新機能

私たちは.NET SDKにいくつかの新機能を追加しました。

.NET規約を中心にSDKを再構築

SDKの古いバージョンでは、あまり".NET "を感じませんでしたが、このリリースではそれが修正されています。

  • すべてのAPIコールをインターフェイスの後ろに抽象化し、テストのための依存性注入による簡単な置換を可能にしました。例えば、レガシーSDKのSMSクラスは、インターフェイスによって置き換えられます。 ISmsClientインターフェイスに置き換えられています。

  • すべての新しい構造体とAPIは、.NETの命名規則に準拠するようになりました。さらに、いくつかのオープンな文字列フィールドを削除するために、多くの新しい列挙型を導入しました。レガシーな構造体は残しましたが、アップグレードを容易にするため、最新バージョンに更新するよう注意を喚起するために、廃止されたものとしてマークしました。

新しいロギング手法

SDKに新しいロギング手段が追加された。 マイクロソフト.エクステンション.ロギング.このため、SDKのロギングを設定して、任意のロギング形式を使用することができます。あなたが望むように、独自のログに準拠させることができ、SDKの出力をログファイルに記録する必要はありません。

私の 説明を参照してください!

サマリー・ドキュメント・ファイルを追加

SDKにはサマリー・ドキュメント・ファイルが付属しており、アプリケーションの構築方法を簡単に決めることができます。

新しいエラー処理方法

すべてのAPIコールは、エラーが発生した場合、何が問題であったかの最善の努力を尽くした説明を含む例外をスローする。これには、すべての4xx、5xxレスポンス、および SMS, Numbers, ナンバー・インサイトそして Verify200 OKレスポンスとエラーコードで応答するかもしれないAPI。これらの例外はすべて NexmoException(サブタイプ NexmoSmsResponseException, NexmoNumberInsightResponseException, NexmoNumberResponseException, NexmoVerifyResponseException) または NexmoHttpRequestException.

レガシーAPIでも同様のエラーが投げられる。

ボンネットの下

また、APIとのインタラクションにはあまり関係ないかもしれないが、それでも興味深いかもしれない、いくつかの重要な機能強化も行った。

リファクタリングされた内部リクエスト・メソッド

内部メソッドのすべてをリファクタリングし ApiRequestメソッドをリファクタリングしました。こちらをご覧ください こちら.

注:これらのメソッドはSDKのパブリックAPIの一部とはみなされず、予告なく変更されることがあります。

単体テスト

私たちは、途中で壊れてしまうことを防ぐために、まったく新しいユニットテスト群を追加した。ユニットテストのカバレッジは4.4.0の33%から5.0では87%になりました。事実上、テストされていないものはすべてレガシーか、SDKに組み込んだサードパーティーのファイルです。

変化への対応

5.0へのアップグレードパスが可能な限りシームレスになるよう、最善を尽くしてきました。

新しい構造は、現在SDKを使用しているユーザーには影響を与えないはずですが、陳腐化に関する警告に耳を傾けることをお勧めします。とはいえ、4.xと5.xの間には、注意すべきいくつかの変更点があります。

  • 私たちはLibLogを削除しました。このため、開発者が何もしなければ、ログは開発者のログと混ざり合うことはないでしょう。

  • APIコールでエラーが発生した場合、新しい例外がスローされる。これにはエラーコードを含む200レスポンスが含まれる。

まだまだ続く

この新しいライブラリは、.NET SDKにとって大きな変化ですが、まだ始まりにすぎません。これからも多くのことをお伝えできることを楽しみにしています!

それまでは、何か質問があれば、私たちのコミュニティ・スラックまでお気軽にどうぞ。 コミュニティ・スラック.

リソース

シェア:

https://a.storyblok.com/f/270183/384x384/73d57fd8eb/stevelorello.png
Steve Lorelloヴォネージの卒業生

元.NETデベロッパーアドボケイト @Vonage、フルスタック・ポリグロティック・ソフトウェア・エンジニア、AI/ML