Langage C et Xcode

19022009 Dans: C

Puisque la question fut posée maintes fois: "Comment programme-t-on en langage C sous XCode".

Créer un projet (pour réunir tous les fichiers)

  • Aller dans le menu File > New Project > Command Line Utility > Standard Tool. Puis cliquer sur Choose.
  • Yapuka éditer le fichier main.c.

Lancer le programme

Pour lancer le programme, direction le menu Build > Build & Run.

Comme il est souvent intéressant de voir du texte s'afficher, il est de bon ton d'ouvrir la Console, par le menu Run > Console.

Y'a qu'à demander.

Utiliser Git avec un projet XCode

28112008 Dans: Logiciel

Un des outils indispensable pour un développeur, est un gestionnaire de versions. Malheureusement XCode gère uniquement CVS, Perforce et Subversion. Si vous avez décidez d'aller voir du coté du gestionnaire distribué Git, voici un article de Christopher Roach sur son utilisation pour gérer un projet XCode :

Il est aussi possible de se servir uniquement de la liste des fichiers à ignorer pour l'adapter à Mercurial par exemple.

Vos débuts en Cocoa

19112008 Dans: Cocoa, Objective-C

Comme promis, cet article sera plus concret que les précédents, je ne vais toutefois pas vous épargner la théorie puisque nous allons aborder un concept important pour Cocoa, le paradigme M-V-C, et voir quelques rudiments du langage Objective-C et de l'utilisation de nos deux outils, XCode et Interface Builder.

Le programme d'exemple

Afin d'être plus concrètes, les explications s'articuleront autour d'un programme simple, pas très éloigné de l'exemple classique d'Apple, à savoir, le convertisseur de monnaie. Cependant, je m'adresse ici à des programmeurs chevronnés qui voudront rapidement en venir aux faits.

Le principe de notre programme est le suivant: une fenêtre comprend deux champs éditables. Taper une température dans le champ Degrés Fahreinheit et valider fait apparaître la conversion dans le champ Degrés Celcius et vice-versa.

Le paradigme M-V-C

À l'instar d'autres bibliothèques de développement, Cocoa est basée sur le paradigme Modèle-Vue-Contrôleur, qui sépare les Vues (l'interface utilisateur) du Modèle (la partie qui conserve les données et effectue les calculs). Le Contrôleur fait les liens entre les deux couches.

MVC

Création du projet

XCode impose la création d'un projet pour regrouper les différents fichiers constituant l'application et définir ses paramètres de construction.

Sous XCode, sélectionnez le menu File > New Project… > Application > Cocoa Application. Cliquez sur Next, tapez un nom pour le projet, et choisissez sa localisation. La fenêtre du nouveau projet s'ouvre; il y a déjà quelques fichiers dans le projet.

Programme principal

Jetez un œil à main.m, dans la rubrique Other Sources:

    #import <Cocoa/Cocoa.h>

    int main(int argc, char *argv[])
    {
        return NSApplicationMain(argc,  (const char **) argv);
    }

Nous reconnaissons la forme canonique utilisée en C pour la fonction main(). Elle ne fait qu'appeler NSApplicationMain() qui va essentiellement créer une instance de la classe NSApplication.

La directive de compilation #import est similaire à #include, si ce n'est qu'un fichier déjà inclus ne le sera pas une seconde fois. On inclut ici cocoa.h qui se trouve dans le framework Cocoa.

Ressources

Dans la rubrique Resources , vous trouverez trois fichiers:

  • Info.plist Comme vous le voyez, il s'agit d'un fichier XML. Vous pouvez d'ailleurs éditer les fichiers .plist grâce à l'utilitaire Property List Editor, mais ce fichier-là peut être édité d'une façon plus conviviale (…c'est vite dit) dans XCode (menu Project > Edit Active Target).

  • InfoPlist.strings Les fichiers .strings servent à traduire une application dans une autre langue — ce qu'on dénomme souvent par le vilain anglicisme localiser. Les clefs y sont associées aux texte traduits. Ce fichier-ci est utilisé pour le texte s'affichant dans la boîte de dialogue À propos de…

  • MainMenu.nib Ce fichier contient des éléments d'interface utilisateur. Double-cliquez-le pour l'ouvrir dans Interface Builder… il y a déjà du monde à l'intérieur.

Couche Vue

Faîtes en sorte que la fenêtre Window ressemble à ceci:

Fenetre

Vous trouverez les éléments dans la palette Library (menu Tools > Library), dans la rubrique Cocoa > Views & Cells. Les champs éditables sont des Text Fields. Les intitulés sont des Label.

Couche Modèle

Nous allons ici créer la classe CFRConvertisseur. Pourquoi pas Convertisseur tout court ? Traditionnellement, les noms de classes commencent par un suffixe pour éviter des conflits (il n'existe qu'un namespace par application). Les classes de Cocoa commencent par NS pour… Next Step.

Sous XCode, dans la fenêtre du projet, sélectionnez la rubrique Classes. Sélectionnez le menu File > New File… > Cocoa > Objective-C Class. Cliquez sur Next, vous serez alors invités à saisir le nom. Tapez donc CFRConvertisseur.m. Puis cliquez sur Finish. Deux fichiers, CFRConvertisseur.m et CFRConvertisseur.h, sont alors insérés dans le projet. Ouvrez donc le .h :

    #import <Cocoa/Cocoa.h>

    @interface CFRConvertisseur : NSObject {

    }

    @end

C'est ainsi que l'on déclare une classe en Objective-C. NSObject est l'objet de base, dont héritent tous les objets, à de rares exceptions près.

On place entre les accolades les définitions des variables d'instances (variables membres). Notre programme n'en nécessitant pas, nous les laissons vides. Nous définissons, entre l'accolade } et @end, les méthodes. Comme nos méthodes n'accèdent pas aux variables d'instance, nous les déclarons comme des méthodes de classes (ce qu'on appellerait des méthodes "statiques" en Java), en les précédant du signe + .

    + (float) convertirCelciusEnFahrenheit:(float)celcius;
    + (float) convertirFahrenheitEnCelcius:(float)fahrenheit;

Pour info: les méthodes d'instances sont précédées du signe - .

Copiez ces deux lignes et ouvrez CFRConvertisseur.m.

Pour ouvrir le .m correspondant au .h courant, et vice-versa, cliquez sur la petite icône counterpart (en haut à droite) ou bien utilisez le menu View > Switch to Header / Source File.

Collez les prototypes des méthodes, afin d'implémenter les formules de conversion:

    #import "CFRConvertisseur.h"

    @implementation CFRConvertisseur

    + (float) convertirCelciusEnFahrenheit:(float)celcius
    {
        return (9.0/5.0) * celcius + 32.0;
    }

    + (float) convertirFahrenheitEnCelcius:(float)fahrenheit
    {
        return (5.0/9.0) * (fahrenheit - 32.0);
    }

    @end

Couche contrôleur

Et maintenant, nous programmons la couche contrôleur, qui fait le lien entre les vues et le modèle. Créez un nouveau fichier source, appelé CFRControleur.m.

Déclarations des outlets

Ouvrez CFRControleur.h. Tout d'abord, nous déclarons les outlets:

    @interface CFRControleur : NSObject {
        IBOutlet NSTextField*   champFahrenheit;
        IBOutlet NSTextField*   champCelcius;
    }

Les outlets sont des variables d'instance, quand notre classe CFRControlleur sera instanciée (à la lecture du fichier .nib), Cocoa fera pointer les variables sur les objets que nous leur auront lié. Nous allons voir ces liaisons dans un instant. Ecrire IBOutlet est nécessaire pour qu'Interface Builder sache qu'il s'agit d'outlets.

N'oubliez pas de rajouter #import "CFRConvertisseur.h"

Déclaration des actions

    @interface CFRControleur : NSObject {
        IBOutlet NSTextField*   champFahrenheit;
        IBOutlet NSTextField*   champCelcius;
    }

    - (IBAction) fahrenheitModifie:(id)sender;
    - (IBAction) celciusModifie:(id)sender;

    @end

Les actions sont des méthodes qui sont appelées lorsqu'un contrôle est actionné. Pour nos champs, cela signifie qu'on aura validé leur contenu en tapant sur Entrée. Une action a forcément un prototype de cette forme. id est le type générique des objets. Nous savons évidemment qu'il s'agit de NSTextFields.

Regardez donc à quoi correspond le symbole IBAction

Sous XCode, pour accéder à la définition d'un symbole, maintenez la touche Commande appuyée, et double-cliquez le symbole.

On peut voir qu'IBAction est équivalent à void et qu'IBOutlet équivaut à rien.

Liaison des Outlets et Actions

Retournez sous Interface Builder. Faîtes apparaître la palette Library (menu Tools > Library). Dans la rubrique Library > Cocoa > Objects & Controllers, vous trouverez un cube bleu, intitulé NSObject. Glissez-le dans la fenêtre MainMenu.nib. Ainsi, Cocoa instanciera un objet de la classe NSObject à l'ouverture du .nib… mais ce n'est pas ce que nous voulons ! Sélectionnez le cube, puis dans la palette Inspector > Object Identity mettez le champ Class à CFRControleur. Vous remarquerez que les actions et outlets sont apparues au bas.

Cliquez sur le cube bleu en maintenant la touche Contrôle appuyée (ou bien clic droit), et reliez le cube au champ Fahrenheit. Quand vous lâchez le bouton, un menu apparaît: choisissez champFahrenheit. Et voilà! L'outlet, champFahrenheit est liée au champ la représentant. Faîtes de même pour le champ Celcius.

Pour les actions, c'est pareil, mais en tirant un segment du champ vers le cube. Je vous laisse faire.

Implémentation des actions

Revenons à XCode et à CFRControleur.m, pour y ajouter les deux méthodes d'actions:

    - (IBAction) fahrenheitModifie:(id)sender
    {
        // Afficher la température convertie dans le champ Celcius
        float fahrenheit = [sender floatValue];
        float celcius = [CFRConvertisseur convertirFahrenheitEnCelcius:fahrenheit];
        [champCelcius setFloatValue:celcius];
    }

Remarquez le [sender floatValue]. Il s'agit d'un appel de méthode, qu'on appelle plus volontiers un message en ObjC. Nous savons que sender est notre NSTextFieldFahrenheit. Nous lui demandons de nous envoyer sa valeur sous la forme d'un float.

[CFRConvertisseur convertirFahrenheitEnCelcius:fahrenheit] est également un message, mais comme convertirFahrenheitEnCelcius: est une méthode de classe, nous la faisons précéder du nom de sa classe.

Finalement, nous demandons au champ Celcius d'afficher la valeur celcius.

Ajoutons l'autre méthode:

    - (IBAction) celciusModifie:(id)sender
    {
        // Afficher la température convertie dans le champ Fahrenheit
        [champFahrenheit setFloatValue:[CFRConvertisseur convertirCelciusEnFahrenheit:[sender floatValue]]];
    }

Cette méthode est similaire à la précedente, si ce n'est que j'ai imbriqué les messages.

Terminez par ajouter

    #import "CFRConvertisseur.h"

Alors ça marche ?

Nous n'avons plus qu'à lancer le programme: menu Run > Run. Ça doit compiler et lancer l'application. Je vous laisse jouer et essayer quelques valeurs.

Quelques améliorations

Vous aurez peut-être remarqué que le programme souffre de deux défauts:

  • trop de chiffres sont affichés (c'est inesthétique)

  • si on entre des caractères plutôt que des chiffres, cela revient à taper zéro (c'est mal).

Retournez sous Interface Builder. Dans la palette Library > Library > Cocoa > Views & Cell, recherchez le Number Formater (un rectangle avec un $ ). Glissez-le sur le champ Fahrenheit. Allez dans la première rubrique de l'Inspecteur (Number Formater Attributes), et mettez-y le menu Style à Decimal. Faîtes de même pour le champ Celcius.

Retournez sous XCode, relancez l'application… les deux défauts sont réglés !

Pour finir

Cet article n'était qu'une introduction, mais vous a cependant présenté les concepts de bases de Cocoa: MVC, édition des .nib, Outlets et actions. Les prochains articles vous aideront à approfondir ces connaissances.

Le projet complet à télécharger, si vous n'avez pas réussi.

Installation des outils développeur

28102008 Dans: Cocoa, Logiciel

Ça y est, vous vous êtes décidé à vous lancer dans la programmation Cocoa. Bravo, mais il va falloir d'abord installer les outils de développement.

Où trouver les outils

Première bonne nouvelle, ces outils sont gratuits. Vous les trouverez à deux endroits:

  • sur le deuxième DVD de Mac OS X qu'il soit livré avec votre machine ou acheté séparément
  • sur l'Apple Developer Connection (ADC). Il faut s'inscrire sur le site. Il existe plusieurs types de comptes ADC, mais celui de base est gratuit, et vous permettra de télécharger entre autres les outils développeur.

Vous devez savoir que, selon la version de Mac OS X qui anime votre machine, vous ne pouvez pas utiliser n'importe quelle version des outils. Ainsi XCode 2.5 fonctionne sous Mac OS 10.4 et 10.5, mais XCode 3.0 est réservé à 10.5. La version actuelle est la 3.1.1.

Ce qui est installé

Une fois l'installation (des plus classiques) terminée, vous trouverez un dossier Developer à la racine de votre disque dur. Nous n'allons pas ici détailler ce qui fut installé (ne serait-ce que parce que je ne connais pas tous les outils); concentrons-nous sur ceux du quotidien:

XCode

Il s'agit d'un intégré de développement, dédié avant tout au développement Cocoa: un éditeur de texte, un éditeur des paramètres des applications, un modélisateur Core Data et de quoi s'interfacer avec les outils externes.

Les programmes en ligne de commande

XCode est surtout est éditeur de texte amélioré, il n'inclut pas de compilateur, mais fait appel au compilateur libre gnu C (tapez gcc dans le terminal pour vérifier qu'il est bien là), au débogueur gnu debug (gdb), ou au gestionnaire de version subversion (svn).

Vous pouvez évidemment utiliser ces outils indépendamment de XCode, mais il vous est toutefois conseillé d'installer ces outils par le biais de l'installateur de XCode, qui se chargera de bien configurer votre environnement.

Interface Builder

Mon programme favori, qui permet d'éditer les interfaces utilisateur. Nous verrons son utilisation de base dans un très prochain article.

Analyse des performances et débogage

De nombreuses applications sont fournies pour vous aider à améliorer votre application :

  • MallocDebug, ObjectAlloc pour analyser les allocations et les fuites mémoire
  • Instruments, Sampler et Shark pour l'étude des performances et un tas d'autres petites applications plus spécifiques que vous aurez l'occasion d'essayer.

Quartz Composer

Introduit avec Mac OS 10.4, il s'agit d'un programme singulier qui permet de composer des animations en couchant des blocs fonctionnels sur une feuille et en les reliant. Les animations résultantes peuvent être utilisées dans vos applications Cocoa, pour créer des économiseurs d'écran, ou être lues directement par QuickTime. Le formidable PulpMotion repose sur QuartzComposer.

Dashcode

Il s'agit d'un éditeur, à mi-chemin de XCode et Interface Builder, pour concevoir les Widgets. Il permet de concevoir leur interface utilisateur et de saisir directement le code JavaScript.

Nous passerons à quelque chose de plus concret dans le prochain article. En attendant, joyeuse installation !

GTK+ sur OS X

26092008 Dans: C, Cocoa, Mac OS X

Si vous voulez développer sur Mac avec le framework GTK+, vous pouvez installez GTK+ on OSX. Cela installera les différentes librairies nécessaires, un framework ainsi qu'un nouveau type de projet sous XCode (GTK+ Application).

Pour ce qui ne connaîtrais pas GTK+, il s'agit de l'équivalent sous Linux et plus particulièrement Gnome de Quartz sous Mac OS X.

Ars Technica vient de publier la 3ème et avant-dernière partie de la série d'articles "Pourquoi passer de Win32 à Cocoa" (From Win32 to Cocoa: a Windows user's conversion to Mac OS X). Peter Bright après avoir abordé comment Apple à réussi à dépasser les erreurs du passé et comment Microsoft à échoué étudie ici tous les petits plus qui rendent Cocoa et le développement sous Mac OS X plus sympathique :

Il peut être utile en phase de beta test d'avoir dans votre application le numéro de révision Subversion. Cela permet de définir clairement quel version utilise exactement un utilisateur. La solution nous est proposé ici par Matteo Rattotti dans l'article Sync Svn version and CFBundleVersion in Xcode.

Il s'agit d'un script en Python utilisant PyObjC et qui est lancé au moment de la compilation de votre application.

La différence entre XCode et Project Builder

24042008 Dans: Apple

Je regardais dernièrement les mots clés les plus fréquents parmi les recherches sur Google amenant des visites vers Cocoa.fr et l'un à tout particulièrement attiré mon attention "différence entre XCode et Project Builder".

J'ai donc fait quelques recherches rapide et Project Builder est tout simplement l'ancien nom de XCode. Je n'ai par contre pas réussi à trouver à quel moment précis ce renommage à été mis en place. Donc si quelqu'un à l'information, qu'il n'hésite pas à laisser un message dans les commentaires.

Les raccourcis claviers de XCode

26022008 Dans: Liens

Colin Wheeler propose sur son blog une cheat sheet permettant de retrouver sur une page, tous les raccourcis de XCode (en anglais) .


Sponsors