Table of Contents

iOS/macOS/visionOS 上的崩潰分析

關於 原生(iOS/macOS) 、 Unity(iOS/macOS/visionOS) 和 Unity 編輯器(macOS) 上的崩潰,可參考如下說明。

開發中的崩潰位置取得

在 XCode 中除錯時需要的資訊如下圖。

crash iOS

在 lldb 中輸入bt,可以獲得崩潰原因和程式碼執行緒堆疊,如下

(lldb) bt
* thread #11, stop reason = EXC_BAD_ACCESS (code=1, address=0x9c40)
* frame #0: 0x00000001057e7cb0 easyar`___lldb_unnamed_symbol2693$$easyar + 6984
    frame #1: 0x00000001057e5e14 easyar`___lldb_unnamed_symbol2692$$easyar + 276
    frame #2: 0x00000001057e2500 easyar`___lldb_unnamed_symbol2532$$easyar + 360
    frame #3: 0x00000001f3d60bfc libsystem_pthread.dylib`_pthread_start + 320

當程式碼執行緒堆疊中存在 easyarlibEasyAR.dylib 相關的內容時,可能說明崩潰和 EasyAR 有關;如果不存在,則有較大概率崩潰和 EasyAR 無關。

在 lldb 中輸入 image list easyar 或者 image list libEasyAR.dylib,可以獲得動態函式庫載入位址,如下

(lldb) image list easyar
[  0] DF06BDD8-A8AF-3982-897D-A906EE229A4F 0x0000000105730000 /Users/<user>/Library/Developer/Xcode/DerivedData/helloar-bpvpobshgxnnwwdiryfjufioysag/Build/Products/Debug-iphoneos/helloar.app/Frameworks/easyar.framework/easyar

開發中的崩潰位置取得(Unity)

在使用 Unity 開發應用時,還可以使用 Unity 的日誌來分析崩潰。

Unity 日誌分為 Unity 編輯器日誌和 Unity 播放器日誌,可以通過以下方法取得。

Unity 環境 作業系統 日誌位址
編輯器 macOS ~/Library/Logs/Unity/Editor.log
播放器 iOS 使用 XCode 的 lldb 控制台
播放器 macOS ~/Library/Logs/Company Name/Product Name/Player.log

編輯器日誌也可以通過 Console 視窗右上角選單的 Open Editor Log 命令開啟。

託管例外(C#)可以在 Unity 編輯器的 Console 視窗中檢視(Unity 主選單的 Window -> General -> Console)。

發布後的崩潰位置取得

發布後,也有可能遇到崩潰的情況。此時從裝置的 Privacy - Analytics & Improvements - Analytic Data 檢視或通過 TestFlight 和 App Store 來收集崩潰日誌

以下為一個崩潰的例子:

Incident Identifier: 5916E252-D8C2-43C3-B583-7E38399597C9
CrashReporter Key:   2075d595d8d96cf07913a12798d5e0aba79c5358
Hardware Model:      iPhone9,2
Process:             ARManualEditorDemo [2352]
Path:                /private/var/containers/Bundle/Application/ED9F6959-612A-4595-A7B9-3F573B5097DD/ARManualEditorDemo.app/ARManualEditorDemo
Identifier:          cn.easyar.demo.ARManualEditor
Version:             6 (2.0.1)
Code Type:           ARM-64 (Native)
Role:                Non UI
Parent Process:      launchd [1]
Coalition:           cn.easyar.demo.ARManualEditor [1831]


Date/Time:           2019-09-17 16:21:13.1246 +0800
Launch Time:         2019-09-17 16:08:08.3605 +0800
OS Version:          iPhone OS 12.4 (16G77)
Baseband Version:    5.70.01
Report Version:      104

Exception Type:  EXC_BREAKPOINT (SIGTRAP)
Exception Codes: 0x0000000000000001, 0x000000019d7e86fc
Triggered by Thread:  0

Thread 0 name:  Dispatch queue: com.apple.main-thread
Thread 0 Crashed:
0   JavaScriptCore                	0x000000019d7e86fc WTFCrashWithInfo+ 2471676 (int, char const*, char const*, int) + 20
1   JavaScriptCore                	0x000000019dd85da0 llint_slow_path_get_by_val + 6032
2   JavaScriptCore                	0x000000019d7a25cc llint_entry + 34380
...
13  JavaScriptCore                	0x000000019d799cec vmEntryToJavaScript + 268
14  JavaScriptCore                	0x000000019dccb4d0 JSC::Interpreter::executeCall+ 7595216 (JSC::ExecState*, JSC::JSObject*, JSC::CallType, JSC::CallData const&, JSC::JSValue, JSC::ArgList const&) + 424
15  JavaScriptCore                	0x000000019dead560 JSC::profiledCall+ 9569632 (JSC::ExecState*, JSC::ProfilingReason, JSC::JSValue, JSC::CallType, JSC::CallData const&, JSC::JSValue, JSC::ArgList const&) + 188
16  JavaScriptCore                	0x000000019d7df170 JSObjectCallAsFunction + 376
17  EasyARPlayer                  	0x000000010353d284 0x10326c000 + 2953860
18  EasyARPlayer                  	0x000000010363c880 0x10326c000 + 3999872
19  EasyARPlayer                  	0x000000010364ee1c 0x10326c000 + 4075036
20  EasyARPlayer                  	0x0000000103295388 0x10326c000 + 168840
21  GLKit                         	0x00000001a337b91c -[GLKView _display:] + 256
...
33  libdyld.dylib                 	0x0000000195e468e0 start + 4

...

Thread 8:
0   libsystem_kernel.dylib        	0x0000000195f92ee4 __psynch_cvwait + 8
1   libsystem_pthread.dylib       	0x000000019600dcf8 _pthread_cond_wait$VARIANT$mp + 636
2   easyar                        	0x0000000102fba7c0 0x1028b4000 + 7366592
3   easyar                        	0x0000000102e7627c 0x1028b4000 + 6038140
4   easyar                        	0x0000000102e452e8 0x1028b4000 + 5837544
5   libsystem_pthread.dylib       	0x00000001960152c0 _pthread_body + 128
6   libsystem_pthread.dylib       	0x0000000196015220 _pthread_start + 44
7   libsystem_pthread.dylib       	0x0000000196018cdc thread_start + 4

...

Binary Images:
0x1023e4000 - 0x1024f3fff ARManualEditorDemo arm64  <0fb0d9b7d18c3e2ebf44e950a68af61f> /var/containers/Bundle/Application/ED9F6959-612A-4595-A7B9-3F573B5097DD/ARManualEditorDemo.app/ARManualEditorDemo
...
0x1028b4000 - 0x10310bfff easyar arm64  <cb52ccf821e33255a0c30ca2422d2862> /var/containers/Bundle/Application/ED9F6959-612A-4595-A7B9-3F573B5097DD/ARManualEditorDemo.app/Frameworks/easyar.framework/easyar
...

EOF

其中,包含 easyar 的程式碼執行緒堆疊有

2   easyar                        	0x0000000102fba7c0 0x1028b4000 + 7366592
3   easyar                        	0x0000000102e7627c 0x1028b4000 + 6038140
4   easyar                        	0x0000000102e452e8 0x1028b4000 + 5837544

這裡的 0x0000000102fba7c0 為程式碼在記憶體中的虛擬位址,0x1028b4000 為 easyar 的模組載入位址,7366592 為偏移量。

Binary Images 的部分也能看出0x1028b4000 為 easyar 的模組載入位址。

需要注意,崩潰資訊中一定要包含程式碼執行緒堆疊和模組載入位址兩部分資訊。由於 ASLR(位址空間配置隨機化),動態函式庫模組載入位址在每次執行時都可能不同,會導致程式碼位址也會動態變化,只有知道程式碼堆疊中的程式碼位址和動態函式庫模組載入位址的相對值,才能知道程式在什麼位置發生了崩潰。

當程式碼執行緒堆疊中存在 easyarlibEasyAR.dylib 相關的內容時,可能說明崩潰和 EasyAR 有關;如果不存在,則有較大概率崩潰和 EasyAR 無關。

其他崩潰相關資訊

  • EasyAR Sense 和 EasyAR Sense Unity Plugin 的版本號

    如 4.7.0.11800-cf8e24e30

  • 社群版/企業版

  • 平台和 CPU 架構

    • iOS

      arm64

    • macOS

      x86_64/arm64

    • visionOS

      arm64