このプロジェクトについて

aptabase-mauiパッケージは、.NET Multi-platform App UI(MAUI)アプリケーションにAptabase分析インスツルメンテーションを追加する.NET SDKです。Aptabaseは、モバイル・デスクトップ・Webアプリ向けのオープンソースでプライバシーファースト、シンプルさを重視した分析プラットフォームとして位置づけられています。 インストールはNuGet経由でプロジェクトファイルにPackageReferenceを追加することで完了します。インストール後、MauiProgram.csでUseAptabase拡張メソッドを使用してSDKを初期化し、アプリケーションキーとオプション設定(デバッグモード、クラッシュレポートの有効化、ディスク上のイベント永続化など)を渡します。 登録後は、SDKが依存関係注入を通じてIAptabaseClientサービスを提供し、任意のページやビューモデルから解決可能です。開発者はTrackEventを手動で呼び出してカスタムイベントを記録します。イベントには文字列と数値値に限定されたカスタムプロパティを付与できます。SDKはオペレーティングシステムやアプリバージョンなどの有用なコンテキストを自動的に付加しますが、何も自動追跡しません—送信されるものを完全に開発者が制御できます。 TrackErrorは処理済みおよび未処理の例外の両方のレポートに対応しています。処理済み例外はerrorまたはfatalのどちらかの重大度として報告できます。EnableCrashReportingを有効にすると、未処理例外、未監視のタスク例外、クラッシュも自動的に捕捉されます。各エラーレポートには例外タイプ、メッセージ、スタックトレース、重大度、ソース分類が含まれます。 EnablePersistenceを有効にすると、イベントがAptabaseサーバーへ送信される前にディスクに保存され、アプリが即座に再起動できない場合でも致命的なクラッシュデータの配達を保証します。すべての追跡操作はバックグラウンドで非同期に実行され、呼び出しスレッドをブロックしません。