SimpleLogger：os.Loggerをラップした軽量Swiftライブラリ

-

SimpleLogger：os.Loggerをラップした軽量Swiftライブラリ

はじめに

iOSアプリ開発において、ログ出力はデバッグや保守の要です。Apple標準の統合ロギングシステムである os.Logger は非常に高機能でパフォーマンスも良いのですが、コードを書く際に「もう少し手軽に呼び出せたらいいのに」と感じることはないでしょうか？

そこで今回、os.Logger のパワーをそのままに、よりシンプルで直感的に扱える軽量なSwift用ラッパーライブラリ「SimpleLogger」を公開しました。 この記事では、自作ライブラリ SimpleLogger の特徴と使い方、そして実装時にこだわったポイントについて紹介します。

SimpleLogger とは？

Info

SimpleLogger は、Apple の os.Logger をラップした軽量な Swift ロギングユーティリティです。

既存の print デバッグではリリース後の追跡が難しく、かといって os.Logger をそのまま使うと初期化や呼び出しが少し冗長になりがちです。このライブラリは、その中間にある「手軽さ」と「実用性」を埋めるために設計しました。

  • リポジトリ: kixking/SimpleLogger
  • 言語: Swift 100%
  • ライセンス: MIT License
  • 最新バージョン: v1.1.1 (2026年1月27日リリース)

主な特徴とこだわり

1. とにかく手軽に使える（ゼロ設定でも動作）

ライブラリを導入してすぐに使い始められるよう、デフォルト設定を用意しています。 特に設定を行わなくても、サブシステム名にはアプリの Bundle Identifier が、カテゴリ名には "General" が自動的に適用されます。

もちろん、機能ごとにログを分けたい場合は、アプリ起動時などに以下のように1行記述するだけでカスタマイズ可能です。

// 任意のサブシステムとカテゴリを設定可能
Log.configure(subsystem: "com.example.MyApp", category: "Networking")

2. 直感的なメソッド名とレベル分け

ログレベルは、開発フローで頻出する4段階に絞っています。

  • info: アプリの動作状況などの一般情報
  • warning: 注意が必要な警告
  • error: 処理の失敗や例外
  • debug: 開発中のみ必要な詳細情報
Log.info("アプリの起動を開始しました")
Log.warning("低メモリ状態を検出しました")

3. Error型をそのまま渡せる

個人的に一番欲しかった機能がこれです。 API通信やファイル操作などで Error が発生した際、わざわざ error.localizedDescription などと変換しなくても、エラーオブジェクトをそのまま渡せるようにしました。 

do {
    try loadData()
} catch {
    // Error型を直接引数に渡せます
    Log.error(error)
}

4. デバッグログの自動除外

開発中には大量に出力したいデバッグ情報も、リリース版ではノイズになったり、パフォーマンスに影響したりします。 Log.debug(...) メソッドは、#if DEBUG 環境下でのみ有効になるよう設計しているため、リリースビルドでは自動的に除外されます。

技術的な注意点：プライバシー保護

Warning

本ライブラリは os.Logger をベースにしているため、Appleの強力なプライバシー保護機能が適用されます。

セキュリティのため、動的な文字列（変数など）を含むログを出力しようとすると、コンソール上ではデフォルトで <private> とマスクされ、表示されない場合があります。これはユーザーの個人情報が意図せずログに残るのを防ぐための仕様です。

開発時の対処法
開発中に変数の値を確認したい場合は、以下のいずれかの方法でマスクを解除できます。

  • Xcodeなどのデバッガを接続した状態で実行する。
  • 「コンソール（Console.app）」の設定でプライベートデータの表示を有効にする。

導入方法

GitHubのリポジトリから Swift Package Manager (SPM) で簡単に追加できます。

https://github.com/kixking/SimpleLogger

Xcodeで File > Add Packages... を選択し、上記のURLを入力してパッケージを追加してください。

まとめ

SimpleLogger は、「多機能すぎず、でも必要な機能は揃っている」を目指して作成したライブラリです。

  • os.Logger の記述を短くしたい
  • エラーハンドリングのログを楽に書きたい
  • リリース時のデバッグログ削除を自動化したい

といったニーズがあれば、ぜひ使ってみてください。フィードバックやStarをいただけると開発の励みになります！

GitHubでリポジトリを見る

© 2026 kixking. All rights reserved.

コメント

コメントを投稿

このブログの人気の投稿

Blogger Sitemap登録エラー解決

-
Blogger Sitemap登録エラー解決 はじめに ブログ運営において、検索エンジンへの登録は非常に重要です。特に、Google検索にブログのコンテンツを適切に認識してもらうためには、 Search Console への登録と、 sitemap の登録が不可欠です。しかし、 Blogger で作成したブログのsitemapを Search Console に登録しようとすると、エラーが発生することがあります。本記事では、その原因と解決策について詳しく解説します。 BloggerのSitemapとは？ Blogger は、ブログの更新情報を自動的に生成するsitemapを提供しています。このsitemapは、ブログのすべての投稿やページをリストアップし、検索エンジンがクロールしやすいように構造化されています。通常、sitemapのURLは「/sitemap.xml?alt=rss」のようになっています。このURLは、ブログのURLに直接アクセスすることで確認できます。このsitemapが正しく機能しているかを確認することも重要です。 Search ConsoleへのSitemap登録で起こりうる問題 Search Console にsitemapを登録する際、以下のようなエラーが発生することがあります。 Sitemap could not be read: ファイルが読み込めないというエラー。 Sitemap is invalid: sitemapの形式が正しくないというエラー。 Sitemap contains errors: sitemapにエラーが含まれているというエラー。 これらのエラーが発生した場合、sitemapのURLが間違っているか、sitemapの形式が正しくない可能性があります。また、robots.txtでsitemapがブロックされている場合も登録できません。 ...
続きを読む

【iOS】SwiftでCGAffineTransformから角度・ラジアン・度数・スケールを計算する方法

-
メモ Swift 4 でtransformから角度、ラジアン、ディグリー、スケールを求める 忘れがちなので・・・。 let transform = view.transform let radians = atan2(transform.b, transform.a) let degrees = radians * 180 / .pi let scale = sqrt(abs(transform.a * transform.d - transform.b * transform.c)) import CoreGraphics extension CGAffineTransform { var angle: CGFloat { return atan2(b, a) } var radians: CGFloat { return angle } var degrees: CGFloat { return angle * 180.0 / CGFloat.pi } var scale: CGPoint { return CGPoint(x: sqrt(a * a + c * c), y: sqrt(b * b + d * d)) } } // 例として、適当な CGAffineTransform を作成 let transform = CGAffineTransform(rotationAngle: CGFloat.pi/4).scaledBy(x: 2.0, y: 1.5) let angleInRadians = transform.radians let angleInDegrees = transform.degrees let scale = transform.scale print("Angle in radians: \(angleInRadians)") print("Angle in degrees: \(angleInDegrees)") print("Scale: \(scale...
続きを読む

Ollama & Open WebUI: ローカルLLM構築

-
Ollama & Open WebUI: ローカルLLM構築 はじめに 近年、大規模言語モデル（LLM）の利用が活発になっていますが、クラウドサービスに依存することなく、ローカル環境でLLMを実行したいというニーズも高まっています。この記事では、OllamaとOpen WebUIを用いて、ローカルLLM環境を構築する方法を解説します。OllamaはLLMのダウンロードと実行を簡素化し、Open WebUIはWebブラウザを通じてLLMと対話するためのインターフェースを提供します。 OllamaとOpen WebUIとは？ Ollama は、LLMのダウンロード、実行、管理を容易にするためのツールです。コマンドラインインターフェース（CLI）を通じて、様々なLLMを簡単に利用できます。 Open WebUI は、Ollamaで実行されているLLMと対話するためのWebベースのインターフェースです。これにより、コマンドラインに慣れていないユーザーでも、GUIを通じてLLMと対話できます。 Ollamaのメリット LLMのダウンロードと実行が簡単 様々なLLMをサポート コマンドラインインターフェースによる柔軟な操作 Open WebUIのメリット Webブラウザを通じてLLMと対話可能 GUIによる直感的な操作 複数モデルの管理が容易 環境構築方法 前提条件 DockerとDocker Composeのインストール Nvidia GPU（推奨） Ollamaのインストール Ollamaは、Dockerを使用して簡単にインストールできます。以下のコマンドを実行してください。 docke...
続きを読む