docs: include more troubleshooting guide in the building.md

[theskumar]

I faced some issues trying to build this project locally. I'm sharing the issues I encountered and their solutions below. Creating an issue here to see if you'd like to integrate these into building.md for future users who might face the same issues.

---

CMake fails with "No CMAKE_C_COMPILER could be found" (Xcode 26+)

CMake's Xcode generator (-G Xcode) does not yet support Xcode 26.x as of CMake 4.2.3. The build-xcframework.sh script in whisper.cpp uses this generator, so building from source will fail.

Workaround: Download the prebuilt whisper.xcframework from the whisper.cpp GitHub releases and place it at ~/VoiceInk-Dependencies/whisper.cpp/build-apple/whisper.xcframework:

mkdir -p ~/VoiceInk-Dependencies/whisper.cpp/build-apple

# Download the latest release (replace version as needed)
gh release download v1.8.3 --repo ggerganov/whisper.cpp \
  --pattern "whisper-*-xcframework.zip" --dir /tmp

# Extract to the expected location
unzip -o /tmp/whisper-*-xcframework.zip -d /tmp/whisper-xcframework
mv /tmp/whisper-xcframework/build-apple/whisper.xcframework \
  ~/VoiceInk-Dependencies/whisper.cpp/build-apple/whisper.xcframework

# Then build VoiceInk
make local

---

xcodebuild fails with "A required plugin failed to load"

If you see an error about IDESimulatorFoundation or CoreSimulator, run the Xcode first-launch setup:

xcodebuild -runFirstLaunch

Then retry the build.

---

Accessibility / Screen Recording permissions not working after rebuild

macOS ties Accessibility and Screen Recording permissions to an app's code signature. After rebuilding VoiceInk (especially when switching between signed and ad-hoc builds), the previously granted permissions may no longer apply even though the app appears enabled in System Settings.

Fix: Reset the permissions and relaunch:

tccutil reset Accessibility com.prakashjoshipax.VoiceInk
tccutil reset ScreenCapture com.prakashjoshipax.VoiceInk

Then quit and relaunch VoiceInk. It will prompt you to re-grant both permissions.