如何调试CMake构建的Nextcloud桌面客户端Finder同步扩展？

前提：构建Debug版本的扩展 #

首先确保你用CMake构建了带调试符号的版本，这是调试的基础：

mkdir build-debug && cd build-debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
make -j$(sysctl -n hw.ncpu)

构建完成后，调试版扩展的bundle通常位于build-debug/src/gui/finderSync/Nextcloud Finder Sync Extension.appex（路径可能根据源码结构略有调整）。

方法1：直接用LLDB附加到扩展进程 #

1. 找到扩展进程：
   运行以下命令定位Nextcloud Finder同步扩展的PID：

   ps aux | grep "Nextcloud Finder Sync"
   

   如果找不到，也可以通过Pluginkit查询扩展的运行状态：

   pluginkit -v -m -p com.apple.FinderSync
   

2. 附加LLDB并调试：
   用PID附加到进程：

   lldb -p <PID>
   

   进入LLDB后，你可以设置断点（比如针对怀疑崩溃的函数）：

   breakpoint set -n <函数名>
   # 例如针对Objective-C方法：
   breakpoint set -n "-[NextcloudFinderSync someMethod:]"
   

   触发操作后，LLDB会在断点处暂停，你可以用bt查看调用栈，frame variable查看变量等。

方法2：启动时调试扩展（避免附加到运行中进程） #

1. 先禁用已安装的正式版扩展：

   pluginkit -e disable -i com.nextcloud.desktopclient.nextcloud.findersync
   

2. 用LLDB直接启动调试版扩展：

   lldb -- <调试版扩展的可执行文件路径>
   # 示例路径：
   lldb -- build-debug/src/gui/finderSync/Nextcloud Finder Sync Extension.appex/Contents/MacOS/Nextcloud Finder Sync Extension
   

   进入LLDB后输入run启动扩展，此时可以直接捕获启动阶段的崩溃。

方法3：调试嵌入Finder的扩展 #

Finder同步扩展通常嵌入Finder进程运行，因此可以直接调试Finder：

1. 关闭当前Finder进程：

   killall Finder
   

2. 用LLDB等待并附加到Finder：

   lldb -n Finder --wait-for
   

3. 设置针对扩展的断点：
   在LLDB中设置断点，比如扩展的初始化方法：

   breakpoint set -n "-[NextcloudFinderSync init]"
   

   然后输入continue，重新打开Finder，扩展加载时会触发断点。

补充：解决Xcode项目无扩展目标的问题 #

如果想通过Xcode调试，重新生成Xcode项目时确保指定正确的架构和Debug模式：

mkdir build-xcode && cd build-xcode
cmake -G Xcode -DCMAKE_BUILD_TYPE=Debug -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64" ..

打开生成的Nextcloud.xcodeproj后，在Xcode的Target列表中，查看Products目录下的子项，或者使用搜索框查找findersync关键字，扩展目标可能嵌套在子项目中。

额外提示：找回崩溃日志 #

如果之前没找到崩溃日志，可以检查以下位置：

• ~/Library/Logs/DiagnosticReports：搜索包含Nextcloud或FinderSync的.crash文件
• 打开控制台.app：在搜索栏输入Nextcloud，查看崩溃报告分类下的内容

内容的提问来源于stack exchange，提问作者Bri Bri