COPYRIGHTED MATERIAL. part I Developing a Professional UI. Chapter 1: Creating a Personal Library. Chapter 2: Advancing with Tableviews

Transcription

1 part I Developing a Professional UI Chapter 1: Creating a Personal Library Chapter 2: Advancing with Tableviews Chapter 3: Advancing with Map Kit Chapter 4: Understanding Action Views and Alerts Chapter 5: Internationalization: Building Apps for the World Chapter 6: Using Multimedia COPYRIGHTED MATERIAL

2

3 1Creating a Personal Library What S IN THIS ChaPter? Creating registering and login logic Configuring application settings Storing settings and securing password Handling crashes in your application Wrox.com Code DoWNloads for this Chapter The wrox.com code downloads for this chapter are found at on the Download Code tab. The code is in the Chapter 1 download and individually named according to the names throughout the chapter. In this chapter you learn how to develop a Personal Library, which is a series of classes and techniques you can use to give you a head start on your projects. Creating a Personal Library will save you time during future projects. The Personal Library you will create during this chapter will teach you how to implement the logic for user registration, user login, and securing password storage. If you ve developed software before, you ve likely noticed a lot of repetitive tasks in each application you ve worked on. This is no different when developing applications for ios, and for that reason Xcode, the Apple Developer Platform, comes with different so-called project templates. The problem with these project templates is that they provide you only with some main object containers and don t provide out-of-the-box configurable features that you require in each application. In this chapter you develop your own configurable Personal Library that you can use for all your subsequent applications. Throughout the different chapters in this book, you extend the Personal Library with additional functionalities.

4 4 CHAPter 1 Creating a Personal Library Creating Your Personal Library The Personal Library you are about to create is basically a project skeleton containing different classes and functionalities to implement repetitive tasks in a flexible and organized way. Functionalities in the Personal Library are: Managing configuration settings Creating a user registration process with a UIViewController Implementing a user login process with a UIViewController Storing user values and secured password storage in a Keychain In your future development projects, you can just drag and drop the files of the Personal Library you require. Understanding Project Basics When you develop ios applications, you have to make some basic choices when you create a new project. Two important choices are: Whether to use Automatic Reference Counting (ARC) Whether to use Interface Builder for the UI composition, or to code the UI components in your controller classes Automatic Reference Counting ARC is a technology introduced in ios 5.x and higher that automatically manages your memory allocations. As the name suggests, it counts the references to objects and retains or releases objects automatically when required. The main advantages of using ARC are: No need to send release or autorelease messages to your objects Less chance for memory leaks in case you forget to release objects Less code to write because you can skip the release for your objects and also skip the dealloc method in most cases The only reason for keeping a dealloc method around is when you need to free resources that don t fall under the ARC umbrella, such as: Calling CFRelease on Core Foundation objects Calling free() on memory you allocated with malloc() Invalidating a timer When you are using source code and/or libraries from other parties, you must keep in mind that not all of them have been updated to support ARC. If you need to work with a class that doesn t support ARC and you still want to use ARC in your project, you can set a compiler flag for the file in question and assign it the value -fno -objc -arc, as shown in Figure 1-1.

5 Creating Your Personal Library 5 Figure 1-1 Interface Builder Because you are an experienced programmer, you know that Interface Builder is a part of Xcode that enables you to create and configure the UI elements of your project. Personally, I don t like working with Interface Builder because I like to have complete control over all aspects of the UI by means of code. The side effect, however, is that a large amount of my code is UI-related code. To keep the source code listings focused on the subject in most of the examples, Interface Builder is used to create the user interface and the Assistant Editor is used to create the IBAction and IBOutlets. Starting a New Project Start Xcode, create a new project using the Single View Application Project template, and name it MyPersonalLibrary using the configuration settings as shown in Figure 1-2. Figure 1-2

6 6 CHAPter 1 Creating a Personal Library The Class Prefix field will help you to follow Apple s coding guidelines because each class within your project needs to have a unique name. When you create the project you can use this field to define your default class prefix, which will be used when you are creating a new class. Although Apple s guidelines advise using a three-character prefix, I always use a two-character prefix the abbreviation of my company name, YourDeveloper so I choose YD as a default prefix for my classes. When you click the Next button, you will be asked to select a file location to store the project, and at the bottom of the screen you will see a checkbox that says Create Local git Repository for This Project, as shown in Figure 1-3. Check the option to create the local git repository and click the Create button to create the project with the chosen configuration. Figure 1-3 USINg a Local git RepoSItory When you select the option to create a local git repository, Xcode creates this repository for you automatically, which enables you to use version control on your project. With version control, Xcode keeps track of changes in your source code, enabling you to revert to a version, commit changes, compare versions, and so on. If you are using a server based subversion system (SVN) to manage your source control you don t require a local git repository since you will be using an SVN client or SVN commands to manage your sources. If you don t use a server based subversion system I strongly recommend to check the Create Local git Repository option when creating a new project. After the project is created, you ll see two classes in the project: the YDAppDelegate class and the YDViewController class. Both classes are created by default by Xcode. You also see a YDViewController.xib file, which is an Interface Builder file. Configuring Your Project It s good practice to use groups in your project structure to organize different elements like images, sounds, classes, views, helpers, and so on, so start by creating some groups under the MyPersonalLibrary node. Create the following groups: Externals Categories CrashHandler Helpers

7 Creating Your Personal Library 7 Definitions Images VC Because a group is only a container and not a physical folder on your filesystem, you should also create these folders on the filesystem under your project root folder. Because there will be a lot of repetitive tasks in all the applications you develop, and you still need the flexibility to switch functionalities on and off without recoding and copying and pasting parts of code, create a configuration file as follows: In the Project Explorer, navigate to the Definitions group and select New File from the context menu. Create a C header file called YDConstants.h as shown in Figures 1-4 and 1-5. Figure 1-4 Figure 1-5

8 8 CHAPter 1 Creating a Personal Library Defining Constants The Personal Library you are developing contains functionality for registration of a user, login of a user, and a settings controller. In addition to that you ll be implementing a crash handler. Implement the code as shown in Listing 1-1 in your YDConstants.h file. ListINg 1-1: Chapter1/MyPersonalLibrary/YDConstants.h #import <Foundation/Foundation.h> // My application switches #define bydactivategpsonstartup YES #define bydregistrationrequired YES #define bydloginrequired NO #define bydshowloginafterregistration YES #define bydinstallcrashhandler YES //keys that are used to store data #define #define #define #define Using the Configuration You can store settings using the NSUserDefaults class. Because you can store or change individual settings in many different places in your application, it s important to first synchronize the object to make sure modifications are presented with the correct value. Next, create a helper class that will give you some static methods to read and write values using the NSUserDefaults class. In the Project Explorer, navigate to the Helpers group and select File New from the context menu. Create a new Objective-C class named YDConfigurationHelper that inherits from NSObject, as shown in Listing 1-2. ListINg 1-2: Chapter1/MyPersonalLibrary/YDConfigurationHelper.h #import YDConfigurationHelper : NSObject +(void)setapplicationstartupdefaults; +(BOOL)getBoolValueForConfigurationKey:(NSString *)_objectkey; +(NSString *)getstringvalueforconfigurationkey:(nsstring *)_objectkey; +(void)setboolvalueforconfigurationkey:(nsstring *) _objectkey withvalue:(bool)_boolvalue;

9 Creating Your Personal Library 9 +(void)setstringvalueforconfigurationkey:(nsstring *) _objectkey withvalue:(nsstring *)_value; The YDConfigurationHelper class in Listing 1-3 contains a few static methods to help you access the NSUserDefaults object. It contains get and set methods for NSString values and BOOL values to make life a lot easier. ListINg 1-3: Chapter1/MyPersonalLibrary/YDConfigurationHelper.m #import YDConfigurationHelper +(void)setapplicationstartupdefaults NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; [defaults setbool:no forkey:bydfirstlaunch]; [defaults setbool:no forkey:bydauthenticated]; [defaults synchronize]; +(BOOL)getBoolValueForConfigurationKey:(NSString *)_objectkey //create an instance of NSUserDefaults NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; //let's make sure the object is synchronized return [defaults boolforkey:_objectkey]; +(NSString *)getstringvalueforconfigurationkey:(nsstring *)_objectkey //create an instance of NSUserDefaults NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; //let's make sure the object is synchronized if ([defaults stringforkey:_objectkey] == nil ) //I don't want a (null) returned else return [defaults stringforkey:_objectkey]; +(void)setboolvalueforconfigurationkey:(nsstring *) _objectkey withvalue:(bool)_boolvalue NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; //let's make sure the object is synchronized continues

10 10 CHAPter 1 Creating a Personal Library ListINg 1-3 (continued) [defaults setbool:_boolvalue forkey:_objectkey]; [defaults synchronize];//make sure you're synchronized again +(void)setstringvalueforconfigurationkey:(nsstring *) _objectkey withvalue:(nsstring *)_value NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; //let's make sure the object is synchronized [defaults setvalue:_value forkey:_objectkey]; [defaults synchronize];//make sure you're synchronized again The getstringvalueforconfigurationkey: method is testing for a null value and returns an empty NSString instead of the null value. The reason is that in case you want to retrieve a value and assign it to the text property of a UILabel, you don t want to display (null). Importing the Header File As you know, when you want to use a header definition file in your application you need to import it using the #import "YDConstants.h" statement. This is not really convenient to repeat in each of your subsequent classes and ViewControllers. Each application, however, also has a precompiled header file that is applicable for the complete application. You can find this under the Supporting Files group in the Project Explorer; it is called MyPersonalLibrary-Prefix.pch. If you import a header file here, it s globally available. Add the import statements here for the YDConstants and YDConfigurationHelper header files, as shown in Listing 1-4. ListINg 1-4: Chapter1/MyPersonalLibrary/MyPersonalLibrary-Prefix.pch #import <Availability.h> #ifdef OBJC #import "YDConstants.h" #import"ydconfigurationhelper.h" #import <UIKit/UIKit.h> #import <Foundation/Foundation.h> #endif In the next section, you create a login, a registration, and a setting ViewController.

11 Registration Login 11 RegIStration LogIN Many applications require the user to register and log in, or log in only. If the user management is handled externally, you can ask a user to register in different ways. You can either ask for credentials like an e mail address or a username and a password, or what you see a lot nowadays you can ask the user to register via Facebook. Facebook registration is covered in depth in Chapter 14, Social Media Integration, and in that chapter, you will extend your Personal Library. Introducing the ios Keychain Services The ios Keychain Services provide you with a secure storage solution for passwords, keys, certificates, notes, and custom data on the user s device. In your Personal Library you ll be using the ios Keychain Services to store the password the user enters during the registration process you ll develop later. To make interaction with the ios Keychain Services more accessible, Apple has released a KeyChainItemWrapper class that will provide you with a higher-level API to work with the keychain. You can download a sample project including the KeyChainItemWrapper class that you need in your Personal Library from GenericKeychain/Listings/Classes_KeychainItemWrapper_h.html. Download the sample project from the URL and navigate to its files using Finder. In your Xcode project use the Project Explorer to navigate to the Externals group, select New Group from the context menu, and name it KeyChain. Create a folder named keychain under the externals folder on your filesystem. Copy the KeychainItemWrapper.h and KeychainItemWrapper.m files from the download folder to your projects folder by using drag-and-drop. Xcode will prompt you to choose the options for adding these files. Make the same choices as shown in Figure 1-6. Figure 1-6

12 12 CHAPter 1 Creating a Personal Library This KeychainItemWrapper class has not been developed for ARC, and for that reason you must set the fno objc arc compiler flag for the KeyChainItemWrapper.m file as already shown in Figure 1-1. For more information about KeyChain Services programming, please visit 01introduction/introduction.html. To be able to work with the Keychain Services using the KeychainItemWrapper class, you also need to add a reference to the Security.framework. Creating Registration Logic Your user registration screen may look different in each application because the design of each application will be different; nevertheless, you can standardize a part of the registration logic because you ll always have to follow certain steps: Verify if the user has registered before so you don t need to present the registration view again. If the user has registered before, define what subsequent processes are required; for example, present a login view or load data from a web service. You already have defined a constant called bydregistrationrequired in the YDConstants header file, which you can use in your application delegate to check if you need to present a ViewController to capture the registration credentials. Using the Project Explorer, navigate to the VC group and select New File from the context menu to create a UIViewController subclass called YDRegistrationViewController as shown in Figure 1-7. Figure 1-7 In this YDRegistrationViewController class, you need to set up a delegate that will notify the delegate ancestor with the result of the registration process. Use Interface Builder and the Assistant Editor to create a user interface with a UILabel, two UITextFields, and two UIButton objects. The YDRegistrationViewController.xib file will look like Figure 1-8.

13 Registration Login 13 Figure 1-8 The YDRegistrationViewController.h code is shown in Listing 1-5. ListINg 1-5: Chapter1/MyPersonalLibrary/YDRegistrationViewController.h #import YDRegistrationViewControllerDelegate <NSObject> -(void)registeredwithsuccess; -(void)registeredwitherror; YDRegistrationViewController : (nonatomic, assign) id<ydregistrationviewcontrollerdelegate> (weak, nonatomic) IBOutlet UITextField (weak, nonatomic) IBOutlet UITextField *passwordfield; - (IBAction)registerUser:(UIButton *)sender; - (IBAction)cancelRegistration:(UIButton *)sender; In YDRegistrationViewController.m, implement the registeruser: and cancelregistration: methods as shown in Listing 1-6. The registeruser: method first hashes the entered password into an MD5 string and then stores it in the keychain.

14 14 CHAPter 1 Creating a Personal Library ListINg 1-6: Chapter1/MyPersonalLibrary/YDRegistrationViewController.m #import "YDRegistrationViewController.h" #import "NSString+MD5.h" #import YDRegistrationViewController delegate; - (id)initwithnibname:(nsstring *)nibnameornil bundle:(nsbundle *)nibbundleornil self = [super initwithnibname:nibnameornil bundle:nibbundleornil]; if (self) // Custom initialization return self; - (void)viewdidload [super viewdidload]; // Do any additional setup after loading the view from its nib. - (void)didreceivememorywarning [super didreceivememorywarning]; // Dispose of any resources that can be recreated. - (IBAction)registerUser:(UIButton *)sender if (([self.namefield.text length]== 0 ) ([self.passwordfield.text length] == 0)) UIAlertView *alert = [[UIAlertView alloc] message:@"both fields are mandatory" delegate:self cancelbuttontitle:@"ok" otherbuttontitles:nil, nil]; [alert show]; else KeychainItemWrapper* keychain = [[KeychainItemWrapper alloc] initwithidentifier:@"ydappname" accessgroup:nil]; [keychain setobject:self.namefield.text forkey:( bridge id)ksecattraccount]; [keychain setobject:[self.passwordfield.text MD5] forkey:( bridge id)ksecvaluedata]; //reading back a value from the keychain for comparison //get username [keychain objectforkey:( bridge id)ksecattraccount]); //get password [keychain objectforkey:( bridge id)ksecvaluedata]);

15 Registration Login 15 [YDConfigurationHelper setboolvalueforconfigurationkey: bydregistered withvalue:yes]; [self.delegate registeredwithsuccess]; //or //[self.delegate registeredwitherror]; - (IBAction)cancelRegistration:(UIButton *)sender [self.delegate cancelregistration]; Initializing Data Each application requires some default settings that are applicable during the launch of the application. For that reason, in this section you learn how to initialize application defaults. Initializing Application Defaults So far you ve been working on creating a Personal Library that contains reusable and configurable code so you don t have to write the same code in each of your applications. You ve been using the NSUserDefaults class via the YDConfigurationHelper class you defined to store settings and results of operations. The first time your application launches, none of these values are set. To support the initialization of your defaults, the YDConfigurationHelper class has a static method called setapplication- StartupDefaults. In the implementation, you set the initial value of each property to control your application s logic at the first launch of an application, as in this example: +(void)setapplicationstartupdefaults NSUserDefaults *defaults = [NSUserDefaults standarduserdefaults]; [defaults synchronize]; [defaults setbool:no forkey:bydfirstlaunch]; [defaults setbool:no forkey:bydauthenticated]; [defaults synchronize]; You also may want to delete keychain items if they are left over from a previous install. This is also an ideal place if you need to create, for example, some special directories outside the bundle, so during further processing in your application you don t have to test each time if a directory exists. The purpose of the bydfirstlaunch key is to support the fact that this initialization code is being called only once. The following code snippet explains how you should call this method in the YDAppDelegate application: didfinishwithlaunchingoptions: method. It tests if the stored value returns YES, and in that case it calls setapplicationstartupdefaults, which sets the value to NO. if (![YDConfigurationHelper getboolvalueforconfigurationkey:bydfirstlaunch]) [YDConfigurationHelper setapplicationstartupdefaults];

16 16 CHAPter 1 Creating a Personal Library Creating Login Logic It is nice that a user can now register, but you also need to support the fact that a registered user can log in. As a first step, create a new ViewController that serves as the ViewController for entering a username and a password. Create a new YDLoginViewController that inherits from UIViewController and code it like in Listing 1-7. Like in the YDRegistrationViewController, you define a protocol that can be used by your delegate so your delegate object will be notified with the result of the login process. Three methods are called depending on the result of the login process. ListINg 1-7: Chapter1/MyPersonalLibrary/YDLoginViewController.h #import YDLoginViewControllerDelegate <NSObject> -(void)loginwithsuccess; -(void)loginwitherror; YDLoginViewController : (weak, nonatomic) IBOutlet UITextField (weak, nonatomic) IBOutlet UITextField (nonatomic, assign) id<ydloginviewcontrollerdelegate> delegate; - (IBAction)loginUser:(UIButton *)sender; - (IBAction)cancelLogin:(UIButton *)sender; The implementation of the YDLoginViewController is shown in Listing 1-8. ListINg 1-8: Chapter1/MyPersonalLibrary/YDLoginViewController.m #import "YDLoginViewController.h" #import "YDLoginViewController.h" #import "NSString+MD5.h" #import YDLoginViewController delegate; - (id)initwithnibname:(nsstring *)nibnameornil bundle:(nsbundle *)nibbundleornil self = [super initwithnibname:nibnameornil bundle:nibbundleornil];

17 Registration Login 17 if (self) // Custom initialization return self; - (void)viewdidload [super viewdidload]; // Do any additional setup after loading the view from its nib. - (void)didreceivememorywarning [super didreceivememorywarning]; // Dispose of any resources that can be recreated. - (IBAction)loginUser:(UIButton *)sender if (([self.namefield.text length]== 0 ) ([self.passwordfield.text length] == 0)) [self showerrorwithmessage:@"both fields are mandatory!"]; else KeychainItemWrapper* keychain = [[KeychainItemWrapper alloc] initwithidentifier:@"ydappname" accessgroup:nil]; if ([self.namefield.text isequaltostring: [keychain objectforkey:( bridge id)ksecattraccount]]) if ([[self.passwordfield.text MD5] isequaltostring:[keychain objectforkey: ( bridge id)ksecvaluedata]]) [self.delegate loginwithsuccess]; else [self showerrorwithmessage:@"password not correct."]; else [self showerrorwithmessage:@"name not correct."]; - (IBAction)cancelLogin:(UIButton *)sender [self.delegate logincancelled]; -(void)showerrorwithmessage:(nsstring *)msg UIAlertView *alert = [[UIAlertView alloc] initwithtitle:@"error" continues

18 18 CHAPter 1 Creating a Personal Library ListINg 1-8 (continued) [alert show]; message:msg delegate:self cancelbuttontitle:@"ok" otherbuttontitles:nil, nil]; In the loginuser: method you see that the first check performed is if both fields have been entered with data. Next, the logic checks if the username is stored and, if so, if the password stored in the keychain is equal to the one that has been entered. The YDLoginViewController.xib file should look something like Figure 1-9. Figure 1-9 Securing Passwords In your YDRegistrationViewController, you accept a value for the username and for the password and store it in the keychain of the device. Many developers still store the username and password using the NSUserDefaults class, which is not a secure solution. This is not a very secure solution because the password is stored in plaintext, and the NSUserDefaults object is not 100 percent safe and can be hacked. To make your Personal Library more secure, implement a category of NSString that creates an MD5 hashed value of the password and store it in the keychain; the only safe place on the device to store critical data. In the Project Explorer, navigate to the Categories group and select New File from the context menu. Select Objective-C Category from the template list as shown in Figure 1-10.

19 Registration Login 19 Figure 1-10 Click the Next button, and in the next screen enter MD5 as the name of the category you are creating. From the Category On drop-down list, select NSString as shown in Figure Figure 1-11 The header file is shown in Listing 1-9. ListINg 1-9: Chapter1/MyPersonalLibrary/NSString+MD5 header #import NSString (MD5) - (NSString *)MD5;

20 20 CHAPter 1 Creating a Personal Library The implementation of your category is shown in Listing 1-10 and the explanation is in the code. ListINg 1-10: Chapter1/MyPersonalLibrary /NSString+MD5 implementation #import "NSString+MD5.h" #import NSString (MD5) - (NSString*)MD5 // Create pointer to the string as UTF8 const char *ptr = [self UTF8String]; // Create byte array of unsigned chars unsigned char md5buffer[cc_md5_digest_length]; // Create 16 bytes MD5 hash value, store in buffer CC_MD5(ptr, strlen(ptr), md5buffer); // Convert unsigned char buffer to NSString of hex values NSMutableString *output = [NSMutableString stringwithcapacity:cc_md5_digest_length * 2]; for(int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) [output appendformat:@"%02x",md5buffer[i]]; return output; In this category you import the <CommonCrypto/CommonDigest.h> header file. To do this, you must add the Security.framework to your project if you haven t already done that when adding the KeychainItemWrapper class. Storing the Password in a Keychain Apple has developed a keychain wrapper class that makes it easy for you to work with the keychain. The KeychainItemWrapper classes are part of the download of this book and are taken directly from Apple s developer portal. This KeychainItemWrapper class has not been developed for ARC, and for that reason you must set the fno objc arc compiler flag for the KeyChainItemWrapper.m file as shown earlier in Figure 1-1. Crash Management Despite all your programming efforts and extensive test processes, your application still might crash. There can be many different reasons for an application to crash, and sometimes it may not even relate to your application at all. In this section you learn about the kinds of crashes that happen and how to implement a crash handler that shows a UIAlertView with a standard message just before the app crashes, so your user knows the application is crashing and might be less irritated.

21 Crash Management 21 The two main reasons for a crash are: Memory leaks Over-releasing objects Memory leaks are most often caused by not releasing your objects. UIImageView, UIImage, and UIWebView are consuming a lot of memory; they definitely need to be released at the right time. Over-releasing happens when you try to access an object that is already released. USINg Instruments Instruments is a performance, analysis, and testing tool for dynamically tracing and profiling ios and OS X code. It s important to have a good understanding of Instruments and how it will help you in improving the quality of your code, by identifying memory leaks, giving you insight into memory consumption, and many other performance-relevant measures. Please visit apple.com/library/ios/#documentation/developertools/conceptual/ InstrumentsUserGuide/Introduction/Introduction.html for the complete documentation on Instruments. You can use Instruments and profile your application to identify memory leaks. You should use the Zombie instrument to identify access to an object that is already released (also known as a zombie). Understanding Crashes At run time, the application s signal handling can, by default, launch six different standard signals in case an application crashes. These signals are: SIGABRT: An abnormal termination SIGFPE: A floating-point exception SIGILL: An invalid instruction SIGINT: An interactive attention request sent to the application SIGSEGV: Access to an invalid memory address SIGTERM: Termination request sent to the application In the next section, you build a global exception handler that captures the signal and presents a UIAlertView to notify the user. Implementing a Crash Handler Create a new class called YDCrashHandler as shown in Listing 1-11.

22 22 CHAPter 1 Creating a Personal Library ListINg 1-11: Chapter1/MyPersonalLibrary/YDCrashHandler.h #import YDCrashHandler : NSObject BOOL dismissed; void InstallCrashExceptionHandler(); The implementation of the class is shown in Listing The class installs an NSSetUncaughtExceptionHandler for each of the available signals. If an exception occurs, the handler is invoked and accesses all modes in the current RunLoop. The process is killed and the back trace is read into an NSDictionary and passed to the handleexception method that presents a UIAlertView. ListINg 1-12: Chapter1/MyPersonalLibrary/YDCrashHandler.m #import "YDCrashHandler.h" #include <libkern/osatomic.h> #include <execinfo.h> NSString * const YDCrashHandlerSignalExceptionName NSString * const YDCrashHandlerSignalKey NSString * const YDCrashHandlerAddressesKey volatile int32_t UncaughtExceptionCount = 0; const int32_t UncaughtExceptionMaximum = 10; const NSInteger UncaughtExceptionHandlerSkipAddressCount = 4; const NSInteger UncaughtExceptionHandlerReportAddressCount = YDCrashHandler + (NSArray *)backtrace void* callstack[128]; int frames = backtrace(callstack, 128); char **strs = backtrace_symbols(callstack, frames); int i; NSMutableArray *backtrace = [NSMutableArray arraywithcapacity:frames]; for ( i = UncaughtExceptionHandlerSkipAddressCount; i < UncaughtExceptionHandlerSkipAddressCount + UncaughtExceptionHandlerReportAddressCount; i++) [backtrace addobject:[nsstring stringwithutf8string:strs[i]]]; free(strs);

23 Crash Management 23 return backtrace; - (void)alertview:(uialertview *)analertview clickedbuttonatindex:(nsinteger)anindex //if (anindex == 0) // dismissed = YES; // - (void)handleexception:(nsexception *)exception UIAlertView *thisalert = [[UIAlertView alloc] initwithtitle:@"sorry" message:@"an unexpected event happened causing the application to shutdown." delegate:nil cancelbuttontitle:@"ok" otherbuttontitles:nil, nil]; [thisalert show]; CFRunLoopRef runloop = CFRunLoopGetCurrent(); CFArrayRef allmodes = CFRunLoopCopyAllModes(runLoop); while (!dismissed) for (NSString *mode in (NSArray *)CFBridgingRelease(allModes)) CFRunLoopRunInMode((CFStringRef)CFBridgingRetain(mode), 0.001, false); CFRelease(allModes); NSSetUncaughtExceptionHandler(NULL); signal(sigabrt, SIG_DFL); signal(sigill, SIG_DFL); signal(sigsegv, SIG_DFL); signal(sigfpe, SIG_DFL); signal(sigbus, SIG_DFL); signal(sigpipe, SIG_DFL); if ([[exception name] isequal:ydcrashhandlersignalexceptionname]) kill(getpid(), [[[exception userinfo] objectforkey:ydcrashhandlersignalkey] intvalue]); else [exception raise]; continues

24 24 CHAPter 1 Creating a Personal Library ListINg 1-12 (continued) void HandleException(NSException *exception) int32_t exceptioncount = OSAtomicIncrement32(&UncaughtExceptionCount); if (exceptioncount > UncaughtExceptionMaximum) return; NSArray *callstack = [YDCrashHandler backtrace]; NSMutableDictionary *userinfo = [NSMutableDictionary dictionarywithdictionary:[exception userinfo]]; [userinfo setobject:callstack forkey:ydcrashhandleraddresseskey]; [[[YDCrashHandler alloc] init] performselectoronmainthread:@selector(handleexception:) withobject: [NSException exceptionwithname:[exception name] reason:[exception reason] userinfo:userinfo] waituntildone:yes]; void SignalHandler(int signal) int32_t exceptioncount = OSAtomicIncrement32(&UncaughtExceptionCount); if (exceptioncount > UncaughtExceptionMaximum) return; NSMutableDictionary *userinfo = [NSMutableDictionary dictionarywithobject:[nsnumber numberwithint:signal] forkey:ydcrashhandlersignalkey]; NSArray *callstack = [YDCrashHandler backtrace]; [userinfo setobject:callstack forkey:ydcrashhandleraddresseskey]; [[[YDCrashHandler alloc] init] performselectoronmainthread:@selector(handleexception:) withobject: [NSException

25 Crash Management 25 exceptionwithname:ydcrashhandlersignalexceptionname reason: [NSString %d was raised.", signal] userinfo: [NSDictionary dictionarywithobject:[nsnumber numberwithint:signal] forkey:ydcrashhandlersignalkey]] waituntildone:yes]; void InstallCrashExceptionHandler() NSSetUncaughtExceptionHandler(&HandleException); signal(sigabrt, SignalHandler); signal(sigill, SignalHandler); signal(sigsegv, SignalHandler); signal(sigfpe, SignalHandler); signal(sigbus, SignalHandler); signal(sigpipe, SignalHandler); Your Personal Library is now ready to be used. Open your YDAppDelegate.h file and implement the code as shown in Listing ListINg 1-13: Chapter1/MyPersonalLibrary/YDAppDelegate.h #import <UIKit/UIKit.h> #import "YDRegistrationViewController.h" #import YDAppDelegate : UIResponder <UIApplicationDelegate, YDLoginViewControllerDelegate, (strong, nonatomic) UIWindow (strong, nonatomic) YDViewController (strong, nonatomic) YDLoginViewController (strong, nonatomic) YDRegistrationViewController *registrationvc; Open your YDAppDelegate.m implementation file and write the code as shown in Listing The application: didfinishlaunchingwithoptions: method first checks if the YDCrashHandler needs to be installed. Next, it checks if the application runs for the first time, and if so, it sets the application startup defaults using the YDConfigurationHelper class. Next, it follows a logic that tests whether or not registration is required. If the previous test returns true, a second test is performed to see if a user registration has been executed before. If registration

26 26 CHAPter 1 Creating a Personal Library needs to be done, the YDRegistrationViewController is presented and the delegate implementation checks if the YDLoginViewController needs to be presented. After the login process has completed with success, the YDMainViewController is presented. The complete implementation is shown in Listing ListINg 1-14: Chapter1/MyPersonalLibrary/YDAppDelegate.m #import "YDAppDelegate.h" #import "YDViewController.h" #import YDAppDelegate - (void)installydcrashhandler InstallCrashExceptionHandler(); - (BOOL)application:(UIApplication *)application didfinishlaunchingwithoptions: (NSDictionary *)launchoptions if (bydinstallcrashhandler) [self performselector:@selector(installydcrashhandler) withobject:nil afterdelay:0]; self.window = [[UIWindow alloc] initwithframe:[[uiscreen mainscreen] bounds]]; if (![YDConfigurationHelper getboolvalueforconfigurationkey:bydfirstlaunch]) [YDConfigurationHelper setapplicationstartupdefaults]; if (bydactivategpsonstartup) //Start your CLLocationManager here if you're application needs the GPS if (bydregistrationrequired &&![YDConfigurationHelper getboolvalueforconfigurationkey:bydregistered]) //Create an instance of your RegistrationViewcontroller self.registrationvc =[[YDRegistrationViewController alloc] init]; //Set the delegate self.registrationvc.delegate=self; self.window = [[UIWindow alloc] initwithframe: [[UIScreen mainscreen] bounds]]; self.window.rootviewcontroller = _registrationvc; self.window.backgroundcolor = [UIColor clearcolor]; [self.window makekeyandvisible];

27 Crash Management 27 else // you arrive here if either the registration is not required or yet achieved if (bydloginrequired) self.loginvc= [[YDLoginViewController alloc] init]; self.loginvc.delegate=self; self.window = [[UIWindow alloc] initwithframe: [[UIScreen mainscreen] bounds]]; self.window.rootviewcontroller = _loginvc; self.window.backgroundcolor = [UIColor clearcolor]; [self.window makekeyandvisible]; else self.viewcontroller= [[YDViewController alloc] init]; self.window.rootviewcontroller =self.viewcontroller; [self.window makekeyandvisible]; #pragma Registration Delegates -(void)registeredwitherror //called from RegistrationViewcontroller if registration failed -(void)registeredwithsuccess //called from RegistrationViewcontroller if the registration with success // if (bydshowloginafterregistration) self.loginvc = [[YDLoginViewController alloc] init]; self.loginvc.delegate=self; self.window = [[UIWindow alloc] initwithframe: [[UIScreen mainscreen] bounds]]; self.window.rootviewcontroller = self.loginvc; self.window.backgroundcolor = [UIColor clearcolor]; [self.window makekeyandvisible]; else self.viewcontroller= [[YDViewController alloc] init]; self.window.rootviewcontroller =self.viewcontroller; [self.window makekeyandvisible]; -(void)cancelregistration //called from RegistrationViewcontroller if cancel is pressed continues

28 28 CHAPter 1 Creating a Personal Library ListINg 1-14 (continued) #pragma Login delegates -(void)loginwithsuccess //called when login with success self.viewcontroller= [[YDViewController alloc] init]; self.window.rootviewcontroller =self.viewcontroller; [self.window makekeyandvisible]; -(void)loginwitherror //called when login with error -(void)logincancelled //called when login is cancelled Summary In this chapter you created a configurable Personal Library that you can use as a starting point for your applications. This Personal Library supports the following features: A single location for configuration settings A registration process with a ViewController A login process with a ViewController Storing values in user defaults Securing password storage by MD5 encryption and keychain storage A Settings ViewController that enables you to use checkboxes to retrieve and store application settings A crash handler to avoid unexpected crashes of your application In the next chapter, you learn how to advance your applications using UITableView objects and customize them to your needs. After you understand the basics for working with UITableView objects, you develop a custom UITableView solution that results in a chat view controller, like the one used in imessage. Finally, you develop a custom UITableView that supports drill-down functionality to improve the user s experience.