EasyLoggerダウンロードEasyLoggerソースコードのダウンロード

EasyLogger

C# ソースコード

EasyLogger release 2.2.0

ダウンロード

EasyLogger

1。はじめに

EasyLoggerは、超軽量（ROM <1.6K、RAM <0.3K）、高性能C/C ++ログライブラリであり、IoT製品、ウェアラブルデバイス、スマートホームなどのリソースに敏感なソフトウェアプロジェクトに最適です。 Log4CやZlogなどのよく知られているC/C ++ログライブラリと比較して、EasyLoggerはより簡単なインターフェイスを提供しますが、プラグインの形での動的拡張をすぐにサポートします。

1.1主な機能

ユーザー定義の出力メソッドをサポートします（例：端末、ファイル、データベース、シリアルポート、485、フラッシュ...）;
ログコンテンツには、レベル、タイムスタンプ、スレッド情報、プロセス情報などを含めることができます。
ログ出力は、スレッドセーフメソッドとして設計されており、非同期出力とバッファー出力モードをサポートします。
複数のオペレーティングシステム（RT-Thread、UCOS、Linux、Windows、Nuttx ...）をサポートし、裸の金属プラットフォームもサポートします。
ログは生形式をサポートし、ヘックスダンプをサポートします。
タグ、レベル、キーワードによる動的フィルタリングをサポートします。
すべてのレベルのログは、表示するさまざまな色をサポートしています。
強く拡張可能で、プラグインの形での新しい機能の拡張をサポートします。

名詞の説明：
1。生形式：フォーマットされていない元のログ。
2。タグ：ソフトウェアでは、ログ分類を実現するには、ファイル、モジュール、関数などに従って印刷する必要があるログのタグを設定できます。

1.2プラグイン

1。フラッシュ：EasyFlashライブラリが提供するフラッシュ操作インターフェイスを使用し、ファイルシステムを必要とせずにログをフラッシュに直接保存します。
2。ファイル：ファイルの転送、ファイルループ保存、およびファイルログ出力に関連するその他の機能をサポートします。
3。ご期待ください...

1.3スター＆フォーク

後でさらにプラグインを提供します。また、EasyLogger （GitHub | Oschina |コーディング）を改善するために、より実用的なプラグインと機能を設計および開発することも歓迎します。このオープンソースプロジェクトが素晴らしいと思われる場合は、プロジェクトのホームページの右上隅にある星をクリックして、困っている友人にそれを推奨できます。

2。使用します

2.1パラメーター構成

EasyLoggerには、フィルタリング方法、出力形式、出力スイッチなどのプロパティがあります。

フィルタリング方法は、ラベル、レベル、キーワードに従ってフィルタリングをサポートします。
ログ出力は動的にオン/オフにすることができます。
動的および静的出力レベルを設定できます
- 静的：マクロで定義された第1レベルのスイッチは、コンピレーション段階で使用されます。
- 動的：セカンダリスイッチは、APIインターフェイスを介した操作段階で使用されます。

注：現在、パラメーター構成と出力メソッドはSingletonモードです。つまり、グローバルにサポートされている構成方法は1つだけです。このモードでは、ソフトウェアはよりシンプルになりますが、複雑な出力方法をサポートすることはできません。

2.2出力レベル

Android LogCatを参照してください。最高レベルは0（アサート）で、最低レベルは5（冗長）です。

 0.[A]：断言(Assert)
1.[E]：错误(Error)
2.[W]：警告(Warn)
3.[I]：信息(Info)
4.[D]：调试(Debug)
5.[V]：详细(Verbose)

2.2.1カラフルなログ出力

各レベルでのログのデフォルトの色効果は次のとおりです。ユーザーは、好みに応じて、 elog_cfg.hでログの色とフォントスタイルを設定することもできます。

2.3出力フィルタリング

レベル、ラベル、キーワードによるフィルタリングをサポートします。ログコンテンツがたくさんある場合、フィルタリング関数を使用してログを高速に配置して、ログの可読性を確保できます。フィルター機能の設定と詳細については、 docszhapikernel.mdドキュメントをお読みください

注：RAW形式とHexdump形式のログは、タグとキーワードフィルタリングをサポートしていません。

2.4出力形式

出力形式は、レベル、時間、ラベル、プロセス情報、スレッド情報、ファイルパス、行番号、メソッド名をサポートしています。各優先レベルは、出力形式を個別に設定できます。

2.5出力方法

ユーザーポーティングを通じて、任意の出力方法をサポートできます。ただし、特定の出力方法で導入される可能性のある新しい機能の場合、ファイル転送、フラッシュログの取得など、プラグインを介して実装する必要があります。より多くのプラグインが後でオープンソースになります。以下は、出力使用シナリオのいくつかの簡単な比較です。

端末：ユーザーが動的に表示するのに便利で、ストレージ機能がありません。
ファイルとフラッシュ：両方にストレージ機能があり、ユーザーは履歴ログを表示できます。ただし、ファイルメソッドにはファイルシステムのサポートが必要であり、Flashメソッドは、ファイルシステムのない小さな組み込みデバイスにより適しています。

2.6デモ

2.6.1コア関数

次の図は、ログ出力とフィルター設定を制御するための端子内の入力コマンドを示しています。これは、EasyLoggerのコア関数をより直感的に示しています。

デモパス： demoosrt-threadstm32f10x
APIドキュメント： docszhapikernel.md
移行文書： docszhportkernel.md

2.6.2フラッシュログ（ログをフラッシュに保存）

次のプロセスは、コンソールからログを出力し、出力ログをフラッシュに保存することです。最後に保存したログを再起動して読み取り、最後にフラッシュログをクリアします。

デモパス： demoosrt-threadstm32f10x
APIドキュメント： docszhapiflash.md
移行文書： docszhportflash.md

2.6.2ファイルログ（ログをファイルに保存）

ファイルプラグインを使用すると、ログをファイルに自動的に保存できます。各ファイルは、指定されたサイズを超えた後、ログを保存するために自動的に作成されます。

3。ドキュメント

特定のコンテンツについては、 docszhの下のファイルを参照してください。ドキュメントを読んだ後は必ず使用してください。

4。後で

フラッシュストレージ：ログストレージと読み取り機能をEasyFlashに追加し、EasyLoggerがシームレスに接続できるようにします。ログをファイル以外のシステムに保存しやすくし、履歴ログ取得の機能を備えています。
構成ファイル：ファイルシステムの下の構成ファイル。
ファイル転送：ファイル転送は、ファイルシステムの容量と時間によってサポートされています。
ログアシスタント：Linux、Windows、およびMacシステムと互換性のあるクロスプラットフォームログアシスタントを開発します。フロントエンド：HTML5 +ブートストラップ + AngularJS + NW.JS、バックエンド：Rust + Iron + Rust-Websocket + Serial-Rs;
非同期出力：現在、ログ出力とユーザーコードは同期されていますが、ログの上書きの問題はありません。ただし、出力速度が低いプラットフォームでは、ロギング機能が追加されるため、ソフトウェアの動作速度が低下します。したがって、非同期出力は後で追加され、キーワードフィルタリングは非同期出力に配置することもできます。
Arduino：Arduino Libを追加し、そのデモを提供しました。