iOS Android 设备日志查看与筛选指南 - 调试崩溃问题必备技能

ios-android-logs by cap-go/capgo-skills

131 周安装量

24 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/cap-go/capgo-skills --skill ios-android-logs

iOS 调试 Android

🇨🇳中文介绍

iOS 和 Android 设备日志

关于在 iOS 和 Android 上查看和筛选设备日志的完整指南。

何时使用此技能

用户需要查看设备日志
用户正在调试崩溃问题
用户希望按应用筛选日志
用户需要实时日志流
用户询问"如何查看日志"

快速命令

# iOS - 从已连接的设备流式传输日志
xcrun devicectl device log stream --device <UUID>

# iOS - 从模拟器流式传输
xcrun simctl spawn booted log stream

# Android - 流式传输所有日志
adb logcat

# Android - 按包名筛选
adb logcat --pid=$(adb shell pidof com.yourapp.id)

iOS 日志

方法 1：Console.app (图形界面)

打开 Console.app (应用程序 > 实用工具)
在侧边栏中选择您的设备
点击"开始流式传输"
使用搜索进行筛选：
- 按进程：process:YourApp
- 按子系统：subsystem:com.yourapp
- 按消息："error"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

方法 2：devicectl (命令行界面 - 推荐)

# 列出已连接的设备
xcrun devicectl list devices

# 从特定设备流式传输日志
xcrun devicectl device log stream --device <DEVICE_UUID>

# 使用谓词筛选器流式传输
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --predicate 'process == "YourApp"'

# 流式传输特定日志级别
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --level error

# 保存到文件
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --predicate 'process == "YourApp"' > app_logs.txt

方法 3：simctl 用于模拟器

# 从已启动的模拟器流式传输日志
xcrun simctl spawn booted log stream

# 按进程筛选
xcrun simctl spawn booted log stream --predicate 'process == "YourApp"'

# 按子系统筛选
xcrun simctl spawn booted log stream --predicate 'subsystem == "com.yourapp"'

# 仅显示错误
xcrun simctl spawn booted log stream --level error

# 组合筛选器
xcrun simctl spawn booted log stream \
  --predicate 'process == "YourApp" AND messageType == error'

方法 4：Xcode 设备日志

窗口 > 设备和模拟器
选择设备
点击"打开控制台"
或者：查看崩溃报告的设备日志

iOS 日志谓词示例

# 进程名称
--predicate 'process == "YourApp"'

# 包含文本
--predicate 'eventMessage contains "error"'

# 子系统
--predicate 'subsystem == "com.yourapp.plugin"'

# 类别
--predicate 'category == "network"'

# 日志级别
--predicate 'messageType == error'

# 组合条件
--predicate 'process == "YourApp" AND messageType >= error'

# 基于时间（最近 5 分钟）
--predicate 'timestamp > now - 5m'

级别	描述
`default`	默认消息
`info`	信息性消息
`debug`	调试消息（默认隐藏）
`error`	错误情况
`fault`	故障/严重错误

方法 1：adb logcat (命令行界面)

# 基本日志流
adb logcat

# 先清除日志，然后流式传输
adb logcat -c && adb logcat

# 按标签筛选
adb logcat -s MyTag:D

# 按优先级筛选
adb logcat *:E  # 仅错误及以上级别

# 按包名筛选
adb logcat --pid=$(adb shell pidof com.yourapp.id)

# 按多个标签筛选
adb logcat -s "MyPlugin:D" "Capacitor:I"

# 保存到文件
adb logcat > logs.txt

# 保存到文件并包含时间戳
adb logcat -v time > logs.txt

方法 2：Android Studio Logcat (图形界面)

视图 > 工具窗口 > Logcat
使用筛选器下拉菜单：
- 包：package:com.yourapp
- 标签：tag:MyPlugin
- 级别：level:error
创建保存的筛选器以便快速访问

方法 3：pidcat (更好的命令行工具)

# 安装 pidcat
pip install pidcat

# 流式传输指定包的日志
pidcat com.yourapp.id

# 带标签筛选器
pidcat -t MyPlugin com.yourapp.id

Android 日志优先级级别

字母	优先级
V	详细
D	调试
I	信息
W	警告
E	错误
F	致命
S	静默

adb logcat 格式选项

# 不同的输出格式
adb logcat -v brief     # 默认
adb logcat -v process   # 仅 PID
adb logcat -v tag       # 仅标签
adb logcat -v time      # 带时间戳
adb logcat -v threadtime # 带线程和时间
adb logcat -v long      # 所有元数据

# 彩色输出
adb logcat -v color

# 显示最近的日志（最后 N 行）
adb logcat -d -t 100

# 显示自某个时间戳以来的日志
adb logcat -v time -T "01-25 10:00:00.000"

常见 Android 筛选器

# Capacitor 核心日志
adb logcat -s "Capacitor:*"

# 特定插件日志
adb logcat -s "CapacitorNativeBiometric:*"

# WebView 日志（JavaScript 控制台）
adb logcat -s "chromium:*"

# JavaScript 错误
adb logcat | grep -i "js error\|uncaught"

# 崩溃日志
adb logcat | grep -iE "fatal|crash|exception"

# 网络日志
adb logcat -s "OkHttp:*" "NetworkSecurityConfig:*"

# 从设备复制崩溃日志
xcrun devicectl device copy crashlog --device <UUID> ./crashes/

# 在 Console.app 中查看
# 用户诊断报告部分

# 或者在此处查找：
# 设备：设置 > 隐私 > 分析与改进 > 分析数据
# Mac：~/Library/Logs/DiagnosticReports/

Android 崩溃日志

# 获取 tombstone（原生崩溃）
adb shell cat /data/tombstones/tombstone_00

# 获取 ANR 跟踪信息
adb pull /data/anr/traces.txt

# 获取 bugreport（全面报告）
adb bugreport > bugreport.zip

使用 MCP 工具以编程方式获取日志：

// 用于获取 iOS 日志的 MCP 工具示例
const logs = await mcp.ios.streamLogs({
  device: 'booted',
  predicate: 'process == "YourApp"',
  level: 'debug',
});

// 用于获取 Android 日志的 MCP 工具示例
const androidLogs = await mcp.android.logcat({
  package: 'com.yourapp.id',
  level: 'D',
});

提取 JavaScript 错误

# iOS - JavaScript 控制台日志
xcrun simctl spawn booted log stream \
  --predicate 'eventMessage contains "JS:"'

# Android - WebView 控制台
adb logcat chromium:I *:S | grep "console"

# iOS
xcrun simctl spawn booted log stream \
  --predicate 'subsystem == "com.apple.network"'

# Android
adb logcat -s "NetworkSecurityConfig:*" "OkHttp:*"

# iOS - 内存压力
xcrun simctl spawn booted log stream \
  --predicate 'eventMessage contains "memory"'

# Android - 内存信息
adb shell dumpsys meminfo com.yourapp.id

问题：不显示日志

确保设备已受信任：Xcode > 窗口 > 设备
尝试重启日志流
检查 Console.app 的筛选器

启用 USB 调试
运行 adb devices 以验证连接
尝试 adb kill-server && adb start-server

问题：日志过多

# iOS - 仅限您的应用
--predicate 'process == "YourApp" AND messageType >= info'

# Android - 仅限您的包
adb logcat --pid=$(adb shell pidof com.yourapp.id)

问题：缺少调试日志

iOS：调试日志默认隐藏

# 启用调试日志
xcrun simctl spawn booted log stream --level debug

Android：确保日志级别设置正确

Log.d("Tag", "Debug message")  // D 级别

使用结构化日志记录 - 在日志消息中包含上下文
添加时间戳 - 有助于关联事件
尽早筛选 - 不要流式传输所有日志
保存重要日志 - 重定向到文件以便后续分析
适当使用日志级别 - 开发用调试级别，生产用错误级别

🇺🇸English

iOS and Android Device Logs

Complete guide to viewing and filtering device logs on iOS and Android.

When to Use This Skill

User needs to see device logs
User is debugging crashes
User wants to filter logs by app
User needs real-time log streaming
User asks "how to see logs"

Quick Commands

# iOS - Stream logs from connected device
xcrun devicectl device log stream --device <UUID>

# iOS - Stream from simulator
xcrun simctl spawn booted log stream

# Android - Stream all logs
adb logcat

# Android - Filter by package
adb logcat --pid=$(adb shell pidof com.yourapp.id)

iOS Logs

Method 1: Console.app (GUI)

Open Console.app (Applications > Utilities)
Select your device in sidebar
Click "Start Streaming"
Use search to filter:
- By process: process:YourApp
- By subsystem: subsystem:com.yourapp
- By message: "error"

Method 2: devicectl (CLI - Recommended)

# List connected devices
xcrun devicectl list devices

# Stream logs from specific device
xcrun devicectl device log stream --device <DEVICE_UUID>

# Stream with predicate filter
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --predicate 'process == "YourApp"'

# Stream specific log levels
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --level error

# Save to file
xcrun devicectl device log stream --device <DEVICE_UUID> \
  --predicate 'process == "YourApp"' > app_logs.txt

Method 3: simctl for Simulators

# Stream logs from booted simulator
xcrun simctl spawn booted log stream

# Filter by process
xcrun simctl spawn booted log stream --predicate 'process == "YourApp"'

# Filter by subsystem
xcrun simctl spawn booted log stream --predicate 'subsystem == "com.yourapp"'

# Show only errors
xcrun simctl spawn booted log stream --level error

# Combine filters
xcrun simctl spawn booted log stream \
  --predicate 'process == "YourApp" AND messageType == error'

Method 4: Xcode Device Logs

Window > Devices and Simulators
Select device
Click "Open Console"
Or: View device logs for crash reports

iOS Log Predicate Examples

# Process name
--predicate 'process == "YourApp"'

# Contains text
--predicate 'eventMessage contains "error"'

# Subsystem
--predicate 'subsystem == "com.yourapp.plugin"'

# Category
--predicate 'category == "network"'

# Log level
--predicate 'messageType == error'

# Combined
--predicate 'process == "YourApp" AND messageType >= error'

# Time-based (last 5 minutes)
--predicate 'timestamp > now - 5m'

iOS Log Levels

Level	Description
`default`	Default messages
`info`	Informational
`debug`	Debug (hidden by default)
`error`	Error conditions
`fault`	Fault/critical

Android Logs

Method 1: adb logcat (CLI)

# Basic log stream
adb logcat

# Clear logs first, then stream
adb logcat -c && adb logcat

# Filter by tag
adb logcat -s MyTag:D

# Filter by priority
adb logcat *:E  # Only errors and above

# Filter by package name
adb logcat --pid=$(adb shell pidof com.yourapp.id)

# Filter by multiple tags
adb logcat -s "MyPlugin:D" "Capacitor:I"

# Save to file
adb logcat > logs.txt

# Save to file with timestamp
adb logcat -v time > logs.txt

Method 2: Android Studio Logcat (GUI)

View > Tool Windows > Logcat
Use filter dropdown:
- Package: package:com.yourapp
- Tag: tag:MyPlugin
- Level: level:error
Create saved filters for quick access

Method 3: pidcat (Better CLI Tool)

# Install pidcat
pip install pidcat

# Stream logs for package
pidcat com.yourapp.id

# With tag filter
pidcat -t MyPlugin com.yourapp.id

Android Log Priority Levels

Letter	Priority
V	Verbose
D	Debug
I	Info
W	Warn
E	Error
F	Fatal
S	Silent

adb logcat Format Options

# Different output formats
adb logcat -v brief     # Default
adb logcat -v process   # PID only
adb logcat -v tag       # Tag only
adb logcat -v time      # With timestamp
adb logcat -v threadtime # With thread and time
adb logcat -v long      # All metadata

# Colorized output
adb logcat -v color

# Show recent logs (last N lines)
adb logcat -d -t 100

# Show logs since timestamp
adb logcat -v time -T "01-25 10:00:00.000"

Common Android Filters

# Capacitor core logs
adb logcat -s "Capacitor:*"

# Plugin-specific logs
adb logcat -s "CapacitorNativeBiometric:*"

# WebView logs (JavaScript console)
adb logcat -s "chromium:*"

# JavaScript errors
adb logcat | grep -i "js error\|uncaught"

# Crash logs
adb logcat | grep -iE "fatal|crash|exception"

# Network logs
adb logcat -s "OkHttp:*" "NetworkSecurityConfig:*"

Viewing Crash Logs

iOS Crash Logs

# Copy crash logs from device
xcrun devicectl device copy crashlog --device <UUID> ./crashes/

# View in Console.app
# User Diagnostics Reports section

# Or find at:
# Device: Settings > Privacy > Analytics & Improvements > Analytics Data
# Mac: ~/Library/Logs/DiagnosticReports/

Android Crash Logs

# Get tombstone (native crash)
adb shell cat /data/tombstones/tombstone_00

# Get ANR traces
adb pull /data/anr/traces.txt

# Get bugreport (comprehensive)
adb bugreport > bugreport.zip

MCP Integration

Use MCP tools to fetch logs programmatically:

// Example MCP tool for fetching iOS logs
const logs = await mcp.ios.streamLogs({
  device: 'booted',
  predicate: 'process == "YourApp"',
  level: 'debug',
});

// Example MCP tool for Android logs
const androidLogs = await mcp.android.logcat({
  package: 'com.yourapp.id',
  level: 'D',
});

Log Parsing Tips

Extract JavaScript Errors

# iOS - JavaScript console logs
xcrun simctl spawn booted log stream \
  --predicate 'eventMessage contains "JS:"'

# Android - WebView console
adb logcat chromium:I *:S | grep "console"

Filter Network Requests

# iOS
xcrun simctl spawn booted log stream \
  --predicate 'subsystem == "com.apple.network"'

# Android
adb logcat -s "NetworkSecurityConfig:*" "OkHttp:*"

Monitor Memory

# iOS - Memory pressure
xcrun simctl spawn booted log stream \
  --predicate 'eventMessage contains "memory"'

# Android - Memory info
adb shell dumpsys meminfo com.yourapp.id

Troubleshooting

Issue: No Logs Showing

iOS :

Ensure device is trusted: Xcode > Window > Devices
Try restarting log stream
Check Console.app filters

Android :

Enable USB debugging
Run adb devices to verify connection
Try adb kill-server && adb start-server

Issue: Too Many Logs

Use filters:

# iOS - Only your app
--predicate 'process == "YourApp" AND messageType >= info'

# Android - Only your package
adb logcat --pid=$(adb shell pidof com.yourapp.id)

Issue: Missing Debug Logs

iOS : Debug logs are hidden by default

# Enable debug logs
xcrun simctl spawn booted log stream --level debug

Android : Ensure log level is set correctly

Log.d("Tag", "Debug message")  // D level

Best Practices

Use structured logging - Include context in log messages
Add timestamps - Helps correlate events
Filter early - Don't stream all logs
Save important logs - Redirect to file for later analysis
Use log levels appropriately - Debug for dev, error for production

Resources

iOS Unified Logging: https://developer.apple.com/documentation/os/logging
Android Logcat: https://developer.android.com/studio/debug/logcat
devicectl Reference: https://developer.apple.com/documentation/devicemanagement

Weekly Installs

Repository

cap-go/capgo-skills

GitHub Stars

First Seen

Feb 6, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykWarn

Installed on

gemini-cli60

opencode58

github-copilot56

codex56

amp54

kimi-cli54

Kotlin 开发模式与最佳实践 | 构建健壮高效应用程序的惯用指南

1,200 周安装