ログの取得方法

iOS

Xcode でローカルビルドできる場合
Console アプリを使用する場合

logLevel 設定の確認

SDK の初期化時にログのコールバックが登録されているか確認します。

OneS1ght.onDebugLog = { level, line in print("[OneS1ght][\(level)] \(line)") }

initialize より先に登録することで、初期化段階のログが残ります。

レベルで絞り込めます。LogLevel は Comparable です。

OneS1ght.onDebugLog = { level, line in
    guard level >= .warn else { return }      // 確認が必要なものだけ
    print("[OneS1ght][\(level)] \(line)")
}

0.1.12 より前は文字列だけが渡されていました — { line in ... }。移行ガイドをご確認ください。

端末の接続

iOS 端末を Mac に接続します。

アプリのビルドと実行

Xcode でアプリをビルドし、接続した端末にインストールして実行します。

コンソールのフィルター設定

Xcode 下部の Console タブを開きます。右下のフィルター入力欄に OneS1ght と入力し、OneS1ght のログだけが表示されるように設定します。

事象の再現

問題が発生する状況を再現します。

ログの保存

約 30 秒間、アプリをフォアグラウンドのまま維持します。 Console のログをすべて選択してコピーし、テキストエディタに貼り付けてファイルとして保存します。

iOS 端末に Xcode から直接ビルドできない場合は、Mac の Console アプリでログを取得できます。

端末の接続

iOS 端末を Mac に接続します。

Console アプリを開く

Spotlight 検索（Cmd + Space）で「Console」を検索してアプリを起動します。

ログストリームの開始

Console アプリ左サイドバーのデバイス一覧から、接続した iOS 端末を選択します。上部の検索・フィルター入力欄に アプリのバンドル ID を入力してフィルタリングします。

ログの初期化

以前のログを消すため、Console ウィンドウを右クリックして Clear Console を選択します。

事象の再現

問題が発生する状況を再現します。

ログの保存

約 30 秒間、アプリをフォアグラウンドのまま維持します。表示されたログをすべて選択してコピーし、テキストエディタに貼り付けてファイルとして保存します。

Console アプリは print で出力した行を取得できない場合があります。端末でのみ再現する問題を確認するときは、 onDebugLog の中で os.Logger にも出力しておくと確実です。

import os
let log = Logger(subsystem: "com.yourcompany.yourapp", category: "OneS1ght")
OneS1ght.onDebugLog = { level, line in
    switch level {
    case .error: log.error("\(line, privacy: .public)")
    case .warn:  log.warning("\(line, privacy: .public)")
    default:     log.info("\(line, privacy: .public)")
    }
}

Console アプリのフィルターには subsystem（com.yourcompany.yourapp）を入力してください。

ログレベル

レベル	意味
`.log`	流れの記録 — 普段は読まなくて構いません
`.info`	知っておくと役立つこと — 正常ですが目に留まると助かります
`.warn`	確認が必要 — 不具合ではありませんが、このままでは期待どおりに動きません
`.error`	不具合 — 直さないとその機能が動きません

不具合をご連絡いただく際は、レベルで絞らずすべてお送りください。不具合の直前の流れが原因を指していることが多くあります。

Android

準備中です。

はじめに

測位インフラ（GeoSpace）

OneS1ght コンソール

開発者ガイド（SDK）

ログの取得方法

iOS

ログレベル

Android

​iOS

​ログレベル

​Android

iOS

ログレベル

Android