#iOS Programming FAQ

This FAQ originated because I noticed a lot of questions were getting repeated on /r/iosprogramming so I've decided to write short and sweet answers to all the common questions here. This is a curated list, and I am actively looking for contributions for both questions and answers, so please submit pull requests.

• Basics
• Prerequisites
• Tools
• SDK
• Common tasks
• Language
  • Should I learn Objective-C or Swift first?
• Cloud and web
• Design
• Community
• Third party code
• The App Store
• Contracting and Employment

##Basics

The most valuable source of information available to iOS Developers is Apple's Developer Library. This contains thousands of documents explaining every single function in the SDK, hundreds of sample applications and several years of WWDC videos. If you've got a problem, this should always be the first place that you should look.

##Prerequisites

###Do I need a Mac?

Yes.

###But I heard that I can use technology X to do iOS development on Windows/Linux/Google Glass.

Irrespective of what you use to write your app, you will still need Xcode on a Mac to compile your app and submit it to the App Store.

###Where can I get the developer tools?

You can download Xcode from the Mac App Store. You can also download the Xcode 6 beta if you're a registered developer (you don't need to be a paid member).

###Which Mac should I get?

Depends what your budget is. Any Mac that can run the latest version of OS X and has more than 4GB of RAM will do. I would recommend Mac Mini or a MacBook Air.

###Is Xcode usable on a MacBook?

Xcode demands a lot of screen space, especially when editing storyboards. It is, however, perfectly usable on a MacBook display, even the 11" MacBook Air. If you've got a retina MacBook Pro you can change the display's resolution so that you get more screen space, which can be very useful when editing storyboards.

###Do I need an iOS device?

Yes, it's imperative that you test your app on a real device before you submit it to the App Store. Besides, you'll probably want to get a feel for how other iOS apps work before you write one.

###Which iOS device?

Provided that you can run iOS 8 you will be fine. This includes the iPod touch 5G, iPhone 4S+ and iPad 2+. Remember, however, that Apple may not support all of these devices for iOS 9. If you're tight on budget then an iPad Mini with Retina Display or an iPod touch is the best option.

###Do I have to pay $99 for the developer license to get my app on the App Store?

Yes.

###So you're saying that I need to buy a Mac, iOS device and developer license?

Yes.

###Where can I find good courses to get me started?

N.B. These are not websites with individual tutorials, but online courses that you work through 'lesson by lesson'. Some of these may also charge money.

• Developing iOS 7 apps for iPhone and iPad by Stanford
• Developing iOS 8 apps with Swift by Stanford
• Complete iOS 8 and Swift course by Udemy
• iOS tutorials on Lynda

##Tools

###Is PaintCode any good?

Yes. Opacity and Opacity Express are some cheaper alternatives that also export Objective-C rendering code, and the vector editor in Opacity is a little better for some tasks. However, only use PaintCode if it is going to save you time and resources - if you aren't using much beyond the default iOS icons or you don't have dynamic graphics you probably don't need it.

###Should I use AppCode or Xcode?

For most developers, Xcode is a fantastic IDE and the vast majority of iOS and OS X developers use it as their primary IDE. The benefit of Xcode is that it gets all the new features - such as the SpriteKit scene editor, Swift support, etc - straight away, whereas AppCode and other apps take longer to get new features.

That said, AppCode does offer some fantastic features for code inspection and refactoring that are - in a word - superior to Xcode's. But if you are starting - you are better of with Xcode.

##SDK

###Where can I find some great examples of Objective-C code?

• NSHipster
• objc.io
• Big Nerd Ranch

###Do I have to use storyboards?

No, you can alternatively use XIB files or generate your user interface in code. However, if you've got a small app storyboards can be very useful for visualising the structure and flow of the app.

###What should I use to store my app's data?

• Plist files. If you are storing small amounts of non-complex data structures use plist files. Array and dictionary collection classes as well as NSData support writing to files with a single line of code.
• Core Data. A framework that provides a generalised way of storing your object graph in SQLite or XML files. For a lot of apps this is the good solution because you are able to take advantage of NSFetchedResultsController to make your table/collection views really slick and update automatically. Unlike other technologies Core Data has a very strict concurrency model, which you must know about before you get started, as it can cause issues down the line.
• FMDB/SQLite. If you aren't going to directly use Core Data then using SQLite is your next best bet. If you're on iOS, the best way to interact with SQLite is through FMDB. Instead of letting Core Data manage your model objects you can create your own model objects from the results of SQL queries. This means that you can use your own concurrency model (although FMDatabaseQueue is a super easy solution to thread safety). If you're interested in something somewhere between FMDB and Core Data you might want to try Marco Arment's FCModel, which is based off of Brent Simmons' description of how he uses FMDB.
• NSUserDefaults. Don't store your object graph in NSUserDefaults, as this is a simple key-value store that is great for storing settings. Do not store sensitive data such as credentials, OAuth tokens or in-app purchase receipts on NSUserDefaults - use Keychain for this instead.

###What frameworks should I use for my game?

• Unity allows you to write cross platform 2/3D games in C# or JavaScript. It provides the vast majority of the tools that you need to get started, and is appropriate for the most iOS games
• SpriteKit is a framework for iOS 7+ and OS X 10.9+ that allows for the development of sprite based 2D games in Xcode. If you aren't bothered about platform lock in and you want to develop a 2D game then this is probably your best bet
• SceneKit has been available since OS X 10.8 and iOS 8. It can integrate with SpriteKit and hugely simplifies the amount of work needed to get 3D graphics on the screen (compared to OpenGL or Metal). If your developing a casual 3D game then SceneKit is a great option
• OpenGL/Metal are the low-level APIs available on iOS for 3D graphics. Most developers will not need to use Metal as this is primarily targeted at game engine developers (and requires a lot more work to do basic 3D graphics). OpenGL is now reasonably easy to get started with thanks to GLKit (iOS 5+) but you still have to do a lot of C and manual memory management. For most casual games SpriteKit or SceneKit are better solutions, and for more complex games it will be easier to use a ready made engine like Unity. However, OpenGL is a good way of learning how 3D graphics work
• Cocos2D is a framework similar to SpriteKit (it allows you to develop 2D games in Objective-C) however has the benefit of being cross platform. Cocos2D is a little older in its API style than SpriteKit, however has a wealth of tutorials and documentation available for it

I would quite like to have a list here of games that use each framework

###Where can I get good advice?

• StackOverflow
• Apple Developer Forums
• NSHipster
• objc.io
• Big Nerd Ranch
• /r/iosprogramming

###Do I need to support iOS 6?

No. Currently around 90% of all iOS devices are on iOS 7 or higher, and by Spring 2015 it will likely be a similar figure for iOS 8. You'll miss out on using the latest APIs and you'll likely have to write a lot of additional code in order to properly support iOS 6. The only major reason to support versions earlier than iOS 7 is if you are developing for a specific audience (such as schools) that may have older devices (such as the iPad 1).

Here's a great list of stats about iOS versions.

###How do I store app settings?

NSUserDefaults. This is a really easy to use class. It is trivial to register default settings, adapt your code to sync via iCloud, or subscribe to settings changes.

##Common tasks

###How can I change my apps' font?

You'll need to use UIAppearance:

//AppDelegate.m
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    UIFont * avenir = [UIFont fontWithName:@"Avenir" size:[UIFont systemFontSize]];
    [[UILabel appearance] setFont:avenir];
    [[UINavigationBar appearance] setTitleTextAttributes:@{NSFontAttributeName: avenir}];
    //You'll need to do this for other classes that display text
    return YES;
}

###How can I request some JSON from the web?

//Standard library JSON request to http://httpbin.org

NSURLSession * session = [NSURLSession sharedSession];

//Prepare the request
NSURL * url = [NSURL URLWithString:@"http://httpbin.org/get"];
NSURLRequest * request = [NSURLRequest requestWithURL:url];

//Prepare the data task
NSURLSessionDataTask * dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    //This block will be executed on the main thread once the data task has completed
    //Status Code is HTTP 200 OK
    //You have to cast to NSHTTPURLResponse, a subclass of NSURLResponse, to get the status code
    if ([(NSHTTPURLResponse*)response statusCode] == 200) {
        NSDictionary * json = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
        NSLog(@"%@", json);
        //The JSON is parsed into standard Cocoa classes such as NSArray, NSDictionary, NSString and NSNumber:
        NSLog(@"The requested URL was %@", json[@"url"]);
    }
}];

//Begin the task
[dataTask resume];

NSURLSession was introduced in iOS 7 and OS X Mavericks. It provides a reasonably easy way to do concurrent network requests, however you may wish to use AFNetworking instead as this can reduce the amount of code you have to write:

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
[manager GET:@"http://httpbin.org/get" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
    //Response object is an NSDictionary, like in the previous example
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    //Handle the error case
    NSLog(@"Error: %@", error);
}];

###I want to build a client app for web service X. How do I get started?

Firstly, you need to confirm that you can legally access the data and that the service provider is OK with you making the app. Secondly, you need to confirm that the service has an API of some sort that you can use. This may be anything from a JSON/XML REST API to a full iOS SDK. If it doesn't, you may be able to scrape HTML but this will be very unreliable as your app would break if the page layout changed.

###My UITextView doesn't scroll properly on iOS 7.

Neither does mine. PSPDFKit has a fix for it though. However, this is now resolved with iOS 8.

##Language

In general, the programming language you work in is only half of the challenge of learning to build an app. The other, more important half, is the frameworks. Often it is easiest to learn to build an app in Objective-C/Swift because the vast majority of documentation, tutorials and support are currently written for Objective-C/Swift. Therefore it is often easier to learn the basics with Objective-C/Swift before applying them in the language of your choice.

If you're considering a non-Apple language (i.e. not Objective-C or Swift), you probably need to consider that the learning curve will be greater, even if you're already familiar with the language. This is because you will have to learn Cocoa Touch, the framework, as well as the various patterns that it uses. These patterns (delegation, for example) may not be familiar in your language of choice, so you will have to adapt to using them whereas they will come more naturally if you learn them in Objective-C or Swift.

###Should I learn Objective-C or Swift first?

TL;DR Swift.

For programmers at any level Swift is easier to learn. The langauge is small, concise and will be familiar to people that have worked in C-like languages before. But you mustn't dismiss Objective-C.

The majority of iOS development tutorials cover using the Cocoa Touch frameworks rather than the language. Everything written pre-June 2014 will be in Objective-C, so any programmer coming to the platform should still be familiar with it.

There is a summary of common patterns in both languages to make it easier for beginners to translate between the two.

###Can I write an iOS app in JavaScript?

Yes, technologies like PhoneGap and Appcelerator make this pretty easy.

###Can I write an iOS app in Ruby?

Yes, with RubyMotion.

###Can I write an iOS app in Java?

Yes, with XMLVM.

###Can I write an iOS app in Python?

You can write games in Python using Kivy. You can also write and run Python on your iOS device with Pythonista.

###Should I write my app with Xamarin?

If you are targeting multiple platforms or the majority of your app's code is 'business logic' then Xamarin may be a really good option, especially if you are already familiar with C#.

###Is there an easy reference for Objective-C block syntax?

fuckingblocksyntax.com

###Is there an easy reference for Swift closure syntax?

fuckingclosuresyntax.com

###Why do Foundation classes start with NS?

Objective-C doesn't support namespaces, so all classes are prefixed with the framework or developer abbreviation. NS = NextStep, which is the company that Apple bought in the 90s and was used to develop OS X and iOS. For your own classes Apple recommends that you use your own two or three letters prefix, especially if you publish the code.

###What is the difference between + and - methods in Objective-C?

Methods that begin with a + are static class methods and are not tied to a particular instance of a class. Class methods are used as:

//UIView method declaration
+ (void)animateWithDuration:(NSTimeInterval)duration animations:(void(^)(void))animations;
//Is used as:
[UIView animateWithDuration:x animations:^{ /* Animations go here */}];

Methods that begin with a - are instance methods, and are related to a single instance of a class:

//UIView method declaration:
- (void)addSubview:(UIView*)subview;
//Is used as:
[someViewInstance addSubview:someSubview];

The same feature exists in Swift, however the syntax is a little less bizarre. All instance methods just use func whereas all static class methods use class func.

###What are extensions?

Unlike other object-oriented programming languages Objective-C has a dynamic runtime that you can use to add methods to exsiting classes. This is useful as it allows you to extend the functionality of an existing Cocoa Touch class without the need to subclass it and make sure you use the subclass everywhere.

Xcode provides a template for extensions, but here is a basic implementation of a map function for NSArray:

//NSArray+FAQ.h

@interface NSArray (FAQ)

/**
 @param mapper An Objective-C block which maps objects in the original array to objects in the new array
 @return An array of mapped objects
*/
- (NSArray*)faq_map:(id(^)(id))mapper;

@end

//NSArray+FAQ.m

@implementation NSArray (FAQ)

- (NSArray*)faq_map:(id (^)(id))mapper {
    NSMutableArray * array = [NSMutableArray arrayWithCapacity:self.count];
    for (id object in self) {
        [array addObject:mapper(object)];
    }
    return array;
}

@end

//Usage:

#import "NSArray+FAQ.h"

NSArray * numbers = @[@1, @2, @3, @4];
NSArray * strings = [numbers faq_map:^id(id object) {
    return [object stringValue];
}];

Apple recommends that if you are writing your own extension methods that you use three letter prefixes (like with class names) so that you avoid clashing with other methods.

###Can I write an app for the Apple Watch in Objective-C?

Yes. Before the Apple Watch a lot of people had suggested online that WatchKit would be Swift only, but it most certainly isn't. You can use Objective-C or Swift to write your Watch app.

##Cloud and Web

###Should I use iCloud Core Data?

A few years ago the answer was absolutely not. Since iOS 7 Apple has hugely improved the quality of the APIs used for syncing data. If you have a simple data model that isn't going to get shared between users that you want to sync between devices then Core Data is a very good choice. objc.io has a great guide to get you started.

###Should I use CloudKit?

CloudKit is a bit different to iCloud Core Data. The benefits of CloudKit is that you get access to a NoSQL-style database, binary data storage and the ability to share data between users. Another very cool feature is that it can send notifications automatically to users based on the results of data queries that run in the cloud. In order to use CloudKit your user will have to a web connection because nothing is cached locally.

###Should I use Parse?

Parse has proven to be a very popular technology owned by Facebook. Its advantages over CloudKit is that it is multi-platform (Android support too) and supports earlier versions of iOS. However, CloudKit has the advantage that identity is automatic (linked with the users' iCloud account) and it is cheaper.

###Should I run my own servers/VPS?

For most developers the answer is probably not. There are three main reasons to run your own servers:

• You need something more than a 'dumb cloud' (i.e. you need something other than the client to manipulate your data)
• You are likely to grow to an enormous Instagram-like scale
• You are experienced in managing servers and it would be cheaper for you to go with AWS/Heroku/DigitalOcean/Linode than some other service

Be warned: running your own servers is a lot of work, and you probably don't need to if you are working on your first cloud-based app.

##Design

###What apps are good for UI design?

Most vector or image editors are OK. Sketch, Photoshop, Pixelmator and Opacity are all great options on the Mac. You may also like to try Facebook's Origami for interaction design.

###Any good design guides or blogs?

The Human Interface Guidelines are a great place to start - but remember that they're guidelines and not rules. Blogs like made for iOS 7 and iOS App designs also showcase great app design.

###Any tips for good design?

• Justify every pixel of your UI - is a control essential for most people?
• Is this interaction obvious? A lot of apps use really interesting combinations of swipes, pinches and taps but make sure that your users will know how to use them.
• Use Auto Layout and size classes. These make it a lot simpler to handle the 5 different screen sizes (iPhone 3.5", iPhone 4", iPhone 4.7", iPhone 5.5", iPad) than writing your layout code manually

###I heard Interface Builder is evil. How do I do everything in code?

Firstly, IB makes many design tasks much easier (especially when setting up Auto Layout constraints) than writing everything in code. The most common complaints when working with IB are that Storyboards prevent you from reusing common views easily without copy/pasting and they don't place nicely with source control. Generally beginners should start out with Storyboards/XIBs before trying to create everything in code.

If you really want to do everything in code, Apple has a guide here.

##Community

###What developer blogs can I read?

• NSHipster
• objc.io
• Swift
• Ash Furrow
• Brent Simmons
• NSBlog (Mike Ash)
• To be continued...

###What podcasts can I listen to?

####Programming specific

• Build and Analyze (finished)
• Build Phase
• CocoaConf
• Core Intuition
• Debug
• Developing Perspective
• Edge Cases
• Identical Cousins (finished)
• iDeveloper
• iOhYes
• iPhreaks
• Iterate
• NSBrief
• Ray Wenderlich
• The Record
• Release Notes
• Springboard (finished?)

####Apple and technology general

• Accidental Tech Podcast
• Hypercritical
• iMore
• The Prompt
• The Talk Show (John Gruber)
• Technically Correct

##Third party code

###Where can I find great third party code?

CocoaPods. CocoaPods is a dependency manager used by Apple developers that makes it really easy to integrate open source code into your iOS or OS X app. Several sites, such as Cocoa Controls keep track of these.

###Should I use CocoaPods/third party code?

The answer for most people is yes. The vast majority of CocoaPods are licensed under MIT or Apache, which means that you can include them in your app, even if it is closed source and commercial. There is a good guide to different licenses here. Also consider whether you are including third party code because it will save you time or you don't know how to do something. You ideally do not want to be in a position where you are publishing an app with code in that you don't know how it works, because you need to support your app.

###Any great CocoaPods that I should know about?

• AFNetworking - library that handles all your networking needs
• FMDB - Objective-C wrapper for SQLite
• GSKeychain - very simple interface for handling keychain operations
• MagicalRecord - easier Core Data
• Pop - dynamic and interactive animation library
• ReactiveCocoa - functional reactive programming library for Cocoa.
• To be continued...

##The App Store

###Will Apple accept my app?

If you need to ask the question, probably not. To quote the App Store review guidelines:

We will reject Apps for any content or behavior that we believe is over the line. What line, you ask? Well, as a Supreme Court Justice once said, "I'll know it when I see it". And we think that you will also know it when you cross it.

###How can I monetize my free app?

Ads or in-app purchase. If you include ads, make sure that you use them conservatively and they don't ruin the user experience. You'll generally need >100,000 users to begin to make a decent amount of money from ads. If you have in-app purchases, then make sure that they offer content or features that genuinely offering something useful.

###Is it OK to include 'rate my app' dialogs?

From Apple's standpoint, yes. But please don't. They're annoying and many people don't like them - some people even do 'revenge one star reviews', but this is probably a bit extreme. A better approach is to include a link to your App Store page in your app's settings or about screen. If you are going to include the dialog, make sure you do the following:

• Only show the dialog after the user has used the app for a reasonable amount of time (after all, it isn't worth showing it to users that use your app for a few minutes and then delete it, because they would probably give it a low rating)
• Show the rating at the most once per version
• Always provide an option to never show the dialog again, and if the user picks this option then don't ever show it again!

###Which ad service should I use?

When you're looking at picking an ad service you need to take into account the eCPM and the fill rate. The eCPM is how much money you make, on average, from 1000 ad impressions. Fill rate is the percentage of ad requests that were successfully responded to with an ad. Ideally this should be as close to 100% as possible. Generally AdMob has a higher rate than iAd.

I'm keen to have some statistics here comparing average fill rate and eCPM for different services, if anyone has it

###How can I get my app featured by Apple?

Build an awesome app that attracts their attention 😀. You can't pay or bribe Apple to feature your app.

###Where should I advertise my app?

Facebook, Twitter, your website, iAd, the web... Make sure you consider your target audience - there is little point in advertising via Facebook if your app is targeted at children under 13.

###My app isn't getting many reviews. What can I do?

Respect your current users and do not spam them with requests for reviews, as above. It isn't really their issue that you aren't getting reviews. You could find a way of politely requesting a review, such as the end of an update description.

###What can I do if somebody copies my app?

If there is a copyright issue (i.e. they're purporting to be you, or they've literally cloned your apps' entire UI and feature set) you need to go through the iTunes Content Dispute system.

##Contracting and Employment

###I'm looking for a job/I want to hire someone. Where should I look?

• Core Inituition Job Board
• iOS Dev Weekly lists jobs listings in its mailing list
• Stack Overflow Job Board

If you've found a job somewhere else that you think should be listed here, pleased add a pull request/issue

###I have an amazing idea for an app. Where can I hire a developer?

###I've written a great app but I don't do design. Where can I hire a designer?