Porting to Android - Learn SpriteBuilder for iOS Game Development - page 447

normal and happens every time—there aren't any incremental transfers that
speed up consecutive transfers as there are on iOS.
Ensure you've followed the Android device setup and connection steps de-
scribed earlier in this chapter. Verify that you didn't enable or disable any de-
velopment settings not mentioned explicitly.
Ensure that the HelloSpriteBuilder iOS project runs fine on an iOS device or
Simulator so that you know the problem is specific to building for Android.
Try issuing a Product Clean Build Folder (by holding the Option key
pressed) in Xcode. At the same time, delete (uninstall) any previously de-
ployed version of the app from the device. And restart Xcode. Then try run-
ning again. Sometimes this can fix the “really weird” kinds of issues.
Be sure to have read the SpriteBuilder Android documentation, specifically
the “Troubleshooting” and “Known Issues” sections: ht-
tp://android.spritebuilder.com .
If you can't resolve the issue, ask about it in the SpriteBuilder forum. When you do, de-
scribe in detail what you attempted and observed, what device you are testing with (mod-
el, Android version), and what SpriteBuilder and Xcode versions you are using.
Note I successfully tested Android deployment with both Xcode 5.1 and Xcode
6.0. I tested on OS X 10.9 Mavericks. If you're still using Xcode 5.0 or earlier
and you do encounter issues, you should consider upgrading Xcode. The OS X
version shouldn't matter though.
If you're using a beta version of Xcode, iOS, or OS X you should consider the
possibility that certain issues may occur exactly because you're using beta soft-
ware. Beta software may introduce compatibility issues with third-party soft-
ware like Cocos2D, SpriteBuilder, or Apportable's BridgeKit.
Anatomy of a SpriteBuilder App
If you examine the files in the HelloSpriteBuilder Xcode project, you'll notice a few curi-
ous additions, especially if you used to work with projects created with SpriteBuilder v1.2
or earlier. Figure 13-15 shows the source tree with some Android-specific files.