Beginner iPhone SDK Hello World Tutorial [Example & Code]

by Adeem Basraa on July 3, 2009 in Tips, Tutorial, Xcode, iPhone, iPhone Development Guide with 43 Comments Tweet

Introduction:

I am going to show you the simplest way to create hello world iPhone tutorial. I will write few more tutorials on the basic of iPhone Development. So this tutorial is an absolute beginner guide for iphone development. To get start with iPhone development you need to have iPhone SDK which you can get from here (http://developer.apple.com/iphone). To download it you need to have a apple developer account which is free for everyone. To test the code on device (iPhone) you need to buy a developer license which cost you 99$ or 299$ for enterprise.

Getting Started with iPhone Development:

To start with hello world iPhone tutorial, you should read the “getting started with iPhone” tutorial which covers the things you need to know before starting development for iPhone( You can also watch the video tutorial of “Getting Started with iPhone” ). I also write a tutorial for businessman and designer to know about the iPhone development cycle (“iPhone Development Guide” ). So if you are a beginner for iPhone, you should read my tutorial before starting iPhone development.

Idea of this tutorial:

There are already many tutorials on hello world in iPhone but I want to write a very basic tutorial on iPhone sdk which will cover xcode, iphone project files and interface builder. This is a basic hello world tutorial which will be extended to a big project later on. So before reading other tutorials on my blog I highly recommended you to read this beginner’s Guide to iPhone development. OR you can watch the video tutorial here if you have no time to follow easy steps .

Final output of hello world tutorial

Hello world iPhone tutorial Output

Simple Steps to create hello world iPhone application

Step 1:If you have read the getting started tutorial, then you have a xcode installed on your mac machine. Open the Xcode and click on File > New Project. Select “View-Based Application” and click on “Choose..” button. Name this project “Hello World” and click “Save” button. Now you have a template for your hello world iphone project.

Create a new Xcode Project for iPhone application

Select the basic design for your first iPhone application

Name your first iPhone applcation

Xcode project template created

Step 2:Now click on Build and Go button to run this template application. It will start the iPhone simulator and you can see a gray screen on that. Click on Home button and it will show you a HelloWorld icon on the dash board of iPhone simulator. If you click on it again, it will open the application again. iPhone simulator is best tool to test your application before you deploy it on your device for testing or even before submitting to apple store.

Build your First iPhone application

Output of your first iPhone application

Press this button to quit your first iPhone application

Step 3:Now open Xcode project and select HelloWorldViewController.h file and type the following code inside interface:

IBOutlet UITextField *txtUserName;
IBOutlet UILabel *lblUserTypedName;
Also write this method before end of this class
- (IBAction) submitYourName;


Step 4:So your HelloWorldViewController.h file will look like this:

#import <UIKit/UIKit.h>

@interface HelloWorldViewController : UIViewController {
IBOutlet UITextField *txtUserName;
IBOutlet UILabel *lblUserTypedName;
}

- (IBAction) submitYourName;
@end

Step 5:Now open HelloWorldViewController.m file and type this method before @end
- (IBAction) submitYourName;{
lblUserTypedName.text = txtUserName.text;
}

Step 6:Now lets start some design on interface builder. For that open your xcode project and in “Group & Files” looked at bottom, you will see “NIB Files”, expand it and you will see two design files for your classes. One is the MainWindow.xib which is the main window or entry point to your application. Other one is HelloWorldViewController.xib file which is mapped to your controller class “HelloWorldViewController.h. For now I just want to change in HelloWorldViewController.xib file. Double click on that file to open it inside interface builder.

Structure of your iPhone application

Interface builder Look

Step 7:Click on Tools  and select Libaray (cmd + shift + L) and drag the text field to your view. As text field is already selected, click on Tools>Inspector (cmd + 1) and in Text field type “Your Name”.

Add label to your First iPhone application

Change text in your UILable

Step 8:Now drag the TextField from Library to your view (cmd+shift+L)  and also drag another Label inside view. Make sure label is selected, Click on tools and select “Size Inspector” (cmd + 3) and change the width of this text field to 250. Also go to tools and select Inspector, change the layout to center.

Add Text field to your first iPhone application

Add another label to your First iPhone application

Change Label Width

Center UILabel from Interface Builder

Step 9:Last thing is to drag a button to the view (19) and then open Inspector again by selecting tools>Inspector. In Title type “Submit”.

Add button to your First iPhone Application

Change Text in your UIButton

Step 10:Now map the controller class variable function and methods with interface builder. Select File’s Owner in Interface builder and select connection inspector from Tools cmd + 2

Map your controller with Interface Builder

Step 11:Now you can see that two new variables are added in connection inspector txtUserName and lblUserTypedName. Click on txtUserName radio button and drag it to text field in view (as you can see in the image)

Map your text field with Interface builder

Step 12:Do the same with lblUserTypedName, select its radio and drag it to below label.

Map your label field with Interface builder

Step 13:Now the last step is, click on submitYourName radio and drag it to the button and select touch down from the list.

Map your button with Interface builder

Set action type of Button

Step 14:Now close the interface and open xcode. Either press cmd + r or cmd + enter or simply press of “build and go” button to run this hello world application. It will open the simulator in iPhone.
Final output

Your first iPhone application Running in simulator

iPhone hello world tutorial code

You can grab this code from here.

Now watch me doing it

Click on this link to view the video screen cast for hello world iPhone application tutorial.

Popularity: 100% [?]

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

Get Shareaholic

Adeem Basraa

My name is Adeem M Basraa. I am a software engineer from Lahore, PK. I’ve been involved in software development for nearly 4 years, with the last 1 year focused on application development for mobile devices (iPhone & Android).

Tagged: Beginner iPhone Tutorial, defualt hello world tutorial, Example of Hello World, hello, Hello world, hello world iphone, Hello world iPhone tutorial, hello world vidoe tutorial for iphone, your first iphone application

43 Comments on "Beginner iPhone SDK Hello World Tutorial [Example & Code]"

1. Toru says:

   July 3, 2009 at 8:10 PM

   Thanks for very nice tutorial! This was very helpful for me.

   BTW, I found a few miner errors:

   Step 3 & 4
   lblUserTypeName -> lblUserTypedName

   Step 5
   Do we need semicolon after submitYourName?

   Step 6
   “NIIB Files” -> “NIB Files”

   Step 7
   text field -> label
2. Adeem Basraa says:

   July 4, 2009 at 12:55 AM

   Thax Toru for correcting me
   About step 5, there is no difference if you put semicolon after the function. But still thanks lot
3. iPhoniacos says:

   July 9, 2009 at 2:43 PM

   Thanks for this great tutorial. I’m starting.
4. Ramsees says:

   July 9, 2009 at 6:53 PM

   I do not understand this line of text, “Now map the controller class variable function and methods with interface builder.” I would be happy if someone explained it to me
5. Adeem Basraa says:

   July 9, 2009 at 7:41 PM

   Interface builder is really a handy tool. Once you write the code on your controller and want to link UILabel and UITextField or UIButton to your views which you made. You have to link them. So link would be a better word to use here (sorry).

   What I want you to do is, after writing the code you want some connection between code and your views (which you design in interface builder). So you select the controller (File’s Owner) and then press cmd + 2 to open Inspector. Now in that place you can see all your class variables or methods which you declare as IBOutlet or IBAction in your .h (header) file.

   So what I want here from your side is, select File’s Owner and then open inspector. Then you will have to link those class variables to interface builder design. You can see the Images or Video I attached with this post. If you still have questions regarding iPhone. Please feel free to contact me.
6. Topkingtips says:

   July 10, 2009 at 12:05 AM

   Thanks for you share now:)really usefull tips
7. AshTemple says:

   July 16, 2009 at 8:06 AM

   Thanks for this, i just made my first iPhone app!
8. Steve H says:

   July 21, 2009 at 6:45 AM

   Thanks for these tutorials. Please, include a script in each tutorial that uses it that makes the keyboard go away. The tut is not finished until the keyboard is gone.

   Thanks!
9. Adeem Basraa says:

   July 21, 2009 at 6:57 AM

   @Steve,
   I am adding a tutorial 2 tomw and you can check it how to hide the Keyboard in that
10. Abhi says:

    August 9, 2009 at 3:34 AM

    Hi Adeem,

    Thanks for the tutorial. I’m just starting and followed the tutorial, but got stuck at “map the controller class variable function and methods “.
    I selected the “File’s Owner” and then opened the connections inspector, but I don’t see the variables there which I could map.

    Could you please help.
11. Adeem Basraa says:

    August 9, 2009 at 7:33 AM

    @Abhi
    send me your code at info @ adeem.me and I will check what you are doing wrong …
12. Manuel F Martinez says:

    November 23, 2009 at 12:02 AM

    Hi everyone,

    I think must people are getting trouble mapping the controller class variables and functions on interface builder because they didn’t build the application before to go into the interface builder.

    It could be solved by adding “Build the application with cmd + B” at the end of the step 5.

    Hope this helps.

    Thanks,
13. Sara says:

    November 27, 2009 at 5:23 PM

    Hello,

    I am just starting so spare with me and thank you very much for the tutorial. I finally was able to make the connections between the variables and the user interface. However, when I run the simulator the screen exits the controller view. So I click again on the app, it acts as if is trying to open the controller view but it doesn’t it just exits again. Any idea of what’s going on there?
14. Imad Qureshi says:

    December 3, 2009 at 2:07 PM

    I think you can use eclipse with aptana plugin to do iPhone app development in windows. Isn’t it true?
15. Dahupi says:

    December 6, 2009 at 5:26 PM

    Great Tutorial – Will keep doing more…
16. hi says:

    December 10, 2009 at 2:38 PM

    this does not work the code messes up says 8 errors 1 warning why????
17. SD says:

    December 24, 2009 at 10:44 AM

    Excellent tutorial especially for a beginner like myself! Thanks.
18. BJ says:

    January 2, 2010 at 10:43 PM

    Hi, I just downloaded and on Snow Leopard. There don’t seem to be a View-Base Application to choose.
    I see only Cocoa Application, Cocoa-AppleScript,Quartz Composer and Command Line Tool. Thanks.
19. Andrew Ames says:

    January 5, 2010 at 5:22 AM

    A helloWorld tutorial should be aimed at complete noobs, yet steps 3 and 4 have no explanation of what the hell you are doing

    I presume they are creating instances of the text field and label, but me being a noob assumed that this would be done using the IB somehow?

    Stupid tutorial man, you need to explain what your getting the noob to do otherwise they aint learning jack
20. P says:

    February 7, 2010 at 8:48 AM

    Great tutorial for starters! I just made my first working iPhone app thanks to this tutorial!

    I’m definitely going to check back here later for more tutorials:)

    Keep up the good work!
21. MH says:

    February 11, 2010 at 5:44 PM

    BJ, I have the same problem, downloaded iPhone SDK, but Xcode does not show the View-based icon. Did you resolve the issue?
22. MH says:

    February 11, 2010 at 6:03 PM

    In fact, to add to my question, the iPhone section in Xcode is missing. Only the Mac OS X section is there. I have installed the iPhone SDK 3.1.3 for Leopard (I have version 10.6.2) with Xcode updates from developer.apple.com/iphone ….
23. MH says:

    February 11, 2010 at 7:13 PM

    Solved. Apparently my existing Xcode was not updated, but a new Xcode (with iPhone development stuff) was installed in another location. That one has both iPhone and Mac development.
24. David says:

    February 13, 2010 at 7:33 PM

    Hi,
    I get this error when compiling and can’t figure it out:

    - (IBAction) submitYourName;
    {
    SecondViewController *controller = [[SecondViewController alloc] initWithNibName:@”SecondView” bundle:nil];
    [self.navigationController pushViewController:controller animated:YES];
    [controller setUserSelectedName:txtName.text];

    error: ‘txtName’ undeclaired’ (first use in function)

    I have tried everythig I can think of, can you shed some much needed light?

    Thanks, David

    // lblUserTypeName.text = txtUserName.text;
    }
25. Dmitry says:

    February 14, 2010 at 11:16 PM

    Hi,Guys, thank’s a lot for a lesson. One question: On the eleventh step in outlets window i can see only one outlet “view”, instead of your screenshots, where is a problem, can you help me please.
    BR
    Dmitry
26. Adeem Basraa says:

    February 15, 2010 at 1:54 PM

    @Dmitry
    Can you see what is selected? Did you select the “Files owner” ?
27. Dmitry says:

    February 15, 2010 at 3:09 PM

    Hi Adeem Basraa!
    I did on the 5th step cmd-b and everythings fime right now!.
    Thankl you for this lesson!
    Best Wishes!
28. Vas says:

    September 12, 2010 at 9:55 PM

    Hi very helpful tutorial for beginner like me , 1 Q how to dismiss the keyboard after type in the text box ? Thank you.
29. moulai says:

    September 20, 2010 at 5:50 AM

    this is nice understandable way.
    u please send dummy projects
30. Adeem Basraa says:

    October 30, 2010 at 1:14 PM

    I didn’t understand your last line.
31. Vikas Saini says:

    February 18, 2011 at 4:24 PM

    Hi,

    I have made a website in VB.net and now i want to make the Iphone application of that website & i also want to use that database which is used for VB.net Website.
    Please guide me how can i make this type of application.Can i use the (Sqlserver2005) for IPhone application?If yes please guide me & if no that how can i make the IPhone application and i want to use that database which is used in my VB.net website.
32. foekall says:

    March 13, 2011 at 11:10 PM

    Hi Adeem Basraa,

    Really thanks for your tutorial.
33. donovan says:

    March 14, 2011 at 12:43 AM

    Thank you so much!! I am an absolute noob and I have been reading and struggling with tutorials for the last day now and yours has been the easiest to use and understand, worked perfectly
34. alok says:

    March 24, 2011 at 3:16 AM

    thanks for the nice tutorial i was having confusion in dragging radios but really its so simple coz of your tut
35. abhishek baghel says:

    April 9, 2011 at 5:27 AM

    hi
    i just started iphone dev and this tutorial is very easy to understand
    i rely appreciate it
    thanks and regards
    abhishek
36. MHMZS says:

    April 29, 2011 at 5:36 PM

    Thank you bro,
    great job. I followed this lesson also i watched the video but when I reached step 10th I don’t have like yours on Qutlets . I am using the last version of SDK. also I had Interface builder files= NIB Files .

    waiting your reply
37. Utkarsh Shah says:

    June 20, 2011 at 8:13 AM

    Great step by step, but the SDK won’t let me connect lblUserTypedName to the actual label. Any help?
38. Priti Parikh says:

    July 5, 2011 at 4:39 AM

    Nice Code!!

    I am able to create iphone Application in Half hour using this

    Code !!

    Thanks
    Priti Parikh
39. Pallavi says:

    August 4, 2011 at 11:27 PM

    great tutorial, thanks
40. VIKRANT BAINS says:

    August 7, 2011 at 3:54 PM

    VERY USEFUL TUTORIAL…..THANKS!!!
41. Thomas Thejlade says:

    August 24, 2011 at 7:35 PM

    Hi
    Thank you, it worked, I will now goto more advanced tutorials. But thank you for this one.

Trackbacks for this post

1. My first iPhone app | AshleyTemple
2. Getting Started with iPhone Dev » iPhone Dev Adventures