Developer secrets in code

[ddttom]

Troubleshooting Guide

Code Signing Issues

Problem: Xcode Build Fails with Code Signing Errors

Error Message:

No Accounts: Add a new account in Accounts settings.
No signing certificate "Mac Development" found: No "Mac Development" signing certificate matching team ID "YYMLDY74QZ" with a private key was found.

Root Cause:
The project had conflicting code signing settings in the Xcode project configuration. The main app target was configured with:

• CODE_SIGNING_REQUIRED = NO (code signing disabled)
• CODE_SIGN_IDENTITY = "Apple Development" (conflicting setting)
• CODE_SIGN_STYLE = Automatic (conflicting setting)
• DEVELOPMENT_TEAM = YYMLDY74QZ (conflicting setting)

When CODE_SIGNING_REQUIRED = NO, the other code signing settings should not be present as they create a contradiction.

Solution:

1. Open the project file Web.xcodeproj/project.pbxproj
2. Remove the conflicting code signing settings from both Debug and Release configurations
3. Keep only CODE_SIGNING_REQUIRED = NO for development builds

Changes Made:

• Removed CODE_SIGN_IDENTITY = "Apple Development"
• Removed CODE_SIGN_STYLE = Automatic
• Removed DEVELOPMENT_TEAM = YYMLDY74QZ
• Kept CODE_SIGNING_REQUIRED = NO

Result:
The build now completes successfully without requiring Apple Developer account credentials or signing certificates for development builds.

Alternative Solutions

If you need code signing enabled for distribution:

1. Add Apple Developer Account:

   • Open Xcode → Preferences → Accounts
   • Add your Apple Developer account
   • Ensure certificates are properly installed

2. Configure Automatic Signing:

   • Set CODE_SIGNING_REQUIRED = YES
   • Set CODE_SIGN_STYLE = Automatic
   • Set DEVELOPMENT_TEAM = [Your Team ID]
   • Remove CODE_SIGN_IDENTITY to let Xcode choose automatically

3. Manual Signing:

   • Set CODE_SIGNING_REQUIRED = YES
   • Set CODE_SIGN_STYLE = Manual
   • Set CODE_SIGN_IDENTITY = [Specific Certificate Name]
   • Set PROVISIONING_PROFILE_SPECIFIER = [Profile Name]

Prevention

To avoid similar issues in the future:

• Be consistent with code signing settings across Debug/Release configurations
• Don't mix CODE_SIGNING_REQUIRED = NO with other code signing settings
• Use Xcode's project settings UI instead of manually editing the project file when possible
• Document any manual changes to the project configuration

Build Performance

The project includes several heavy dependencies (MLX frameworks, Swift Transformers) that can make initial builds slow. Subsequent builds should be faster due to incremental compilation.

First Build: ~2-3 minutes (includes downloading and compiling MLX frameworks)
Incremental Builds: ~30-60 seconds (only changed files)

Common Build Issues

Missing Dependencies

If you encounter missing framework errors, ensure all Swift Package Manager dependencies are resolved:

xcodebuild -resolvePackageDependencies

Clean Build

If you encounter persistent build issues, try a clean build:

xcodebuild clean -project Web.xcodeproj -scheme Web

Derived Data Issues

If builds fail unexpectedly, clear derived data:

rm -rf ~/Library/Developer/Xcode/DerivedData