Photo by Artem Maltsev on Unsplash

How to Fix Common Xcode Build Issues Part-2

Encountering build issues in Xcode can be frustrating, especially when you’re in the middle of development. One common problem is related to asset catalog compilation errors and entitlements. In this article, we’ll walk through a real-world example and provide solutions to fix these issues.

Example Issue: Build Error in Xcode

Here’s an example of an error log you might encounter:

piconset/layer-2-dpi.png is 113x117 but should be 80x80.
/* com.apple.actool.compilation-results */
/Users/hipster/Library/Developer/Xcode/DerivedData/random_project_app-etiuzknfthmdhtakkpsbfooxfdvc/Build/Intermediates.noindex/random_project_app.build/Debug-iphonesimulator/random_project_app.build/assetcatalog_generated_info.plist
/Users/hipster/Library/Developer/Xcode/DerivedData/random_project_app-etiuzknfthmdhtakkpsbfooxfdvc/Build/Products/Debug-iphonesimulator/random_project_app.app/Assets.car

warning: Capabilities for Signing & Capabilities may not function correctly because its entitlements use a placeholder team ID. To resolve this, select a development team in the random_project_app editor. (in target 'random_project_app' from project 'random_project_app')

** BUILD FAILED **

The following build commands failed:
 CompileAssetCatalog /Users/hipster/Library/Developer/Xcode/DerivedData/random_project_app-etiuzknfthmdhtakkpsbfooxfdvc/Build/Products/Debug-iphonesimulator/random_project_app.app /Users/hipster/development/random-project/random_project_app/ios/random_project_app/Images.xcassets (in target 'random_project_app' from project 'random_project_app')
(1 failure)

Understanding the Issues

There are two primary issues here:

1. Incorrect Image Dimensions: piconset/layer-2-dpi.png is 113x117 but should be 80x80.
2. Placeholder Team ID: Warning about signing capabilities due to a placeholder team ID.

Step-by-Step Solution

1. Fixing Image Dimensions

The first issue is related to an image having incorrect dimensions. Xcode expects the image to be 80x80 pixels, but the current dimensions are 113x117 pixels.

Steps to Fix:

• Open your image editor (e.g., Photoshop, GIMP).
• Resize the image to the correct dimensions (80x80 pixels).
• Replace the old image with the resized image in your Xcode project.

Alternatively, you can use command-line tools like sips to resize the image:

sips -z 80 80 /path/to/your/image.png

2. Resolving Placeholder Team ID

The second issue is a warning about signing and capabilities. This occurs because the project is using a placeholder team ID.

Steps to Fix:

1. Open your project in Xcode.
2. Navigate to the project settings by clicking on the project name in the Project Navigator.
3. Go to the “Signing & Capabilities” tab.
4. In the “Team” dropdown, select your development team. If you don’t have one, you can create one for free on the Apple Developer website.
5. Ensure that all targets in your project have the correct team selected.

Verifying the Fixes

After applying the fixes, it’s important to verify that the issues are resolved.

1. Clean the Project: In Xcode, go to the Product menu and select Clean Build Folder.
2. Rebuild the Project: Build the project again by selecting Product > Build.
3. Check for Errors: Ensure that there are no errors or warnings related to image dimensions or entitlements.