2009
free - Xcode Workflow Tutorial.pages
G U I DA N U M E RO 1
GRATIS
“ H E L L O, WORLD” IN XC OD E
COMMUNITY ITALIANA
PROGRAMMATORI APPLE
Indice
Premessa! 4
Prerequisiti! 4
PARTE I!________________________________________5
La finestra di Xcode! 5
La Toolbar! 6
Page!..........................................................................................................................6
Overview!...................................................................................................................6
Action!........................................................................................................................6
Breakpoints!..............................................................................................................6
Tasks!.........................................................................................................................7
Info!.............................................................................................................................7
Search!.......................................................................................................................7
Editor View! 8
La Finestra di Documentazione! 9
Usare InterfaceBuilder! 13
Implementiamo il codice ! 18
2 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Ringraziamenti!_________________________________20
Premessa
Questo documento è stato realizzato dai ragazzi di XcodeItalia free (http://
www.xcodeitalia.org) solo a scopo di puro diletto.
Ma come è nato ”Hello, World” in Xcode ? Semplicemente parlando nel nostro forum... ci
è venuta l'idea di scegliere un documento di Apple e crearne uno tutto nostro: così
abbiamo preso il seguente documento originale:
http://developer.apple.com/Mac/library/documentation/DeveloperTools/Conceptual/
A_Tour_of_Xcode/000-Introduction/qt_intro.html#//apple_ref/doc/uid/TP30000890-
CH204-TPXREF101 e lo abbiamo letto, tradotto in Italiano, ed infine riscritto a modo
nostro.
Prerequisiti
Si da per scontato che abbiate un minino di nozioni di Objective-C.
In caso aveste bisogno di studiare questo linguaggio, vi è un libro in ITALIANO scritto
dall'amministratore di xcodeitalia.org.
4 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
PARTE I
La finestra di Xcode
Prima di creare la nostra applicazione è opportuno capire, anche se superficialmente,
come è strutturato Xcode.
Toolbar
Groups & Files list
Detail View
Editor
Status Bar
La Toolbar
La Toolbar è molto utile per muoverci velocemente attraverso i comandi di Xcode. Come
per qualsiasi applicazione, anche Xcode permette di modificare a nostro piacimento la
toolbar: basta cliccare con in tasto destro del mouse sopra la toolbar e
selezionare Customize Toolbar... .
Page
Permette di cambiare l'ambiente tra Progetto e Debug.
Overview
Permette di cambiare velocemente tra SDK, configurazione,
target, eseguibile e architettura.
Action
Visualizza le operazioni che si possono effettuare sull'elemento selezionato
(praticamente equivale a cliccare con il tasto destro del mouse sull'elemento).
Breakpoints
Attiva tutti i breakpoints che abbiamo inserito nel listato. Automaticamente l'icona Build
and Run cambia in Build and Debug.
6 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Tasks
Ferma il task in esecuzione.
Info
Apre un pannello il quale ci permette di leggere le informazioni riguardanti l'elemento
selezionato. Se selezioniamo il nome del progetto (in Groups & Files) possiamo
modificare anche i parametri di compilazione.
Search
Permette di filtrare in Detail View i files. Ad esempio se scriviamo List verranno mostrati
tutti i files che contengono questa stringa.
Inoltre possiamo anche modificare il tipo di ricerca se clicchiamo sulla lente:
Editor View
Quest'area è multifunzionale: visualizza le informazioni dei files selezionati ed il codice
sorgente del file selezionato. Nonostante questo editor sia molto potente ci limiteremo a
descrivere le proprietà principali.
(1) Questa colonna può essere utilizzata per inserire i breakpoints, ma è utile anche per
poter visualizzare i numeri di riga previo attivazione nelle preferenze. Infine Xcode
utilizza questa colonna per visualizzare i possibili warning o error nella rispettiva
linea di codice
(2) Questa colonna permette di nascondere parti di codice, o meglio parti di blocco (si
ricorda che un blocco inizia con la parentesi graffa e finisce con la parentesi graffa)
(3) Questo è l'editor per scrivere il codice. Quando scriviamo il codice al suo interno
possiamo beneficiare del completamento automatico del codice che suggerisce la
parola mentre scriviamo. Premendo il tasto TAB accettiamo la parola suggerita,
8 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
mentre premendo ESC vengono mostrati i suggerimenti. In caso parametri, come
per esempio metodi con argomenti, saranno visualizzati e, premendo il tasto TAB,
possiamo passare al successivo parametro
(4) Le frecce permettono di passare da una posizione all'altra. Ogni qualvolta ci
muoviamo in Xcode vi è una cronologia e con queste frecce ci muoviamo al suo
interno (come paragone pensiamo alle frecce di un browser)
(5) Ogni files aperto viene memorizzato, perciò questo menù ci permette di navigare
nella cronologia dei files aperti
(6) Permette di saltare tra i simboli (funzione, metodo, ...) del codice sorgente
(7) Permette di saltare tra i segnalibri
(8) Permette di saltare tra i Beakpoints
(9) Permette di saltare tra le Classi
(10) Permette di saltare ad i files inclusi (esempio #import <Cocoa/Cocoa.h>)
(11) Permette di passare tra il file implementazione (.m) ed il corrispondente file di
interfaccia (.h) e viceversa
(12) Permette di bloccare il file (cioè non permette di modificare il file)
La Finestra di Documentazione
Xcode ha integrato una Guida che permette di aiutare il programmatore nella ricerca
della API, note, ecc...
Per aprire la documentazione basta selezionare dal menù a tendina Help > Developer
Documentation (shortcut: ⎇⌘?)
PARTE II
Adesso che abbiamo fatto un breve tour su Xcode, possiamo passare alla nostra
applicazione.
10 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Scegliamo il nome della nostra applicazione (esempio Hello) e la directory dove salvare il
nostro progetto. Clicchiamo su Save.
Xcode crea tutto il necessario per la nostra applicazione, tra cui il file main.m. La
funzione main() è essenziale perché il programma inizia con questa funzione e finisce
con essa. Ecco come si presenta:
Abbiamo detto che deve essere di tipo NSView, per cui diciamo che la nostra classe sarà
una sottoclasse di NSView così erediterà tutti (o quasi tutti) i metodi di NSView :
12 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Clicchiamo su Finish.
14 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
e, in caso non fosse aperto l'Inspector, selezioniamo dal menù di Xcode Tools > Inspector.
Selezioniamo da quest'ultimo gli attributi:
Adesso, sempre dal menù di Xcode, selezioniamo Tools > Library. La Library contiene
oggetti e media da aggiungere alla applicazione.
16 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Ridimensionandolo per tutta la finestra.
Adesso dobbiamo collegare l'oggetto Custom View alla classe precedentemente creata
(altrimenti avremmo un oggetto che non appartiene a nessuna classe). Per fare ciò, con
la Custom View selezionata apriamo nell'Inspector il tab Identity e scriviamo HelloView :
Poi dal Size Inspector impostiamo la finestra in modo tale che se la finestra viene
ridimensionata, automaticamente il contenuto verrà anch'esso ridimensionato.
Impostiamo come da figura:
Implementiamo il codice
Da Xcode selezioniamo il file HelloView.m e modifichiamolo come segue (il testo
evidenziato in giallo è quello da aggiungere):
18 http://www.xcodeitalia.org
XcodeItalia free - “Hello, World” in Xcode
Ringraziamenti
Si ringraziano gli utenti del forum di di XcodeItalia free:
• 369
• Bonny92
• Geppy Parziale
• jockerfox
• revolt_nobody
• sper
20 http://www.xcodeitalia.org