Je vais donc revendre mon iMac 20 pouces (que pourtant j’adooore) ainsi que mon MacBook 13 pouces noir.

Mon iMac est disponible immédiatement pour environ 830 euros. Le MacBook sera disponible quand j’aurai le nouveau et terminé la migration (dans l’été, donc) pour environ 800 euros. Ces deux (superbes) machines seront entièrement ré-installées proprement avec la dernière version de Mac OS X et livrées dans leur boîte d’origine, avec tous les accessoires (télécommande, chiffon de nettoyage et DVD de Mac OS X).

Si vous êtes intéressés, ou si vous connaissez des personnes qui pourraient être intéressées, n’hésitez pas à prendre contact avec moi.

Cet article parle de notions présentées dans ce tutoriel pour Xcode et Interface Builder. N’hésitez pas à aller vous rafraîchir la mémoire !

Dans Interface Builder, ajoutons une Combo Box dans notre vue puis, dans le premier onglet de l’inspecteur, cochons… tiens, il est marrant ce verbe conjugué au présent à la première personne du pluriel ! Hum. Cochons, donc, la case Uses Data Source.

La datasource est un objet de votre choix qui contient les données à afficher dans la liste déroulante. Cet objet retrouve et stocke les données sous la forme qu’il souhaite. Généralement, on a souvent affaire à un NSArray qui pourrait être lu depuis un fichier plist… ou depuis les User Defaults. Bref, la seule contrainte est que cet objet doit implémenter le protocole informel NSComboBoxDataSource :

- (NSInteger)numberOfItemsInComboBox:(NSComboBox *)combo;
- (id)comboBox:(NSComboBox *)combo objectValueForItemAtIndex:(NSInteger)index

La première méthode doit retourner le nombre d’éléments qui devront être présents dans la liste déroulante. La seconde retourne l’objet pour un index donné (le message description sera envoyé à cet objet pour l’affichage dans la liste déroulante). Remarquez que ces méthodes acceptent toutes les deux une NSComboBox en argument. Ceci permet de n’utiliser qu’une seule classe pour gérer plusieurs sources de données : en fonction de l’objet combo passé en argument, il est facile de déterminer les données à utiliser.

Dans notre exemple, considérons que l’objet datasource est notre contrôleur principal, déclaré dans Interface Builder. On peut donc utiliser sa méthode awakeFromNib pour initialiser ce qu’on veut. Ici, on va récupérer des données stockées dans les User Defaults :

- (void) loadDataSource {
   // On récupère une instance des User Defaults
   NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
   // On lit les valeurs avec la clé qu'on a choisit (ici : ComboBoxValues)
   // dataSource est un NSArray déclaré dans le fichier header de cette classe
   dataSource = [[defaults arrayForKey:@"ComboBoxValues"]
                           sortedArrayUsingSelector:@selector(compare:)];
   // Au passage, on trie les éléments par ordre alphabétique :-)
}
 
-(void)awakeFromNib {
   // On charge nos données depuis les "préférences" de l'utilisateur
   [self loadDataSource];
}

Ensuite, nous allons implémenter les deux fameuses méthodes du protocole NSComboBoxDataSource qui sont, comme vous le constatez, très complexes :

- (int)numberOfItemsInComboBox:(NSComboBox *)aComboBox {
    return [dataSource count];
}
 
- (id)comboBox:(NSComboBox *)aComboBox objectValueForItemAtIndex:(int)index {
    return [dataSource objectAtIndex:index];
}

Il nous reste à indiquer à notre NSCombBox la datasource à utiliser. Allons dans Interface Builder, sélectionnons la liste déroulante, activons l’onglet Connections de l’inspecteur puis relions l’entrée dataSource à notre contrôleur.

Très bien, mais il faut encore ajouter les données saisies dans les User Defaults, sinon l’entrée ComboBoxValues (voir la méthode loadDataSource) sera toujours un tableau vide… Et on aurait fait tout ça pour rien ! Il faut d’abord obtenir une instance de notre liste déroulante dans notre contrôleur via l’utilisation des IBOutlet (plus d’informations ici). Ensuite, il faut déterminer le moment où vous l’on souhaite que la valeur soit sauvegardée : lorsque que l’utilisateur termine la saisie dans la liste déroulante ou bien lors d’une autre action (sauvegarde des différents champs d’un formulaire, par exemple). Dans les deux cas, il faut déclarer une IBAction quelque part (plus d’informations ici). Dans cette action, il nous faut ajouter un morceau de code qui ressemble à ceci :

// Récupération de la valeur saisie dans la NSComboBox
// comboBox est un IBOutlet déclaré dans le fichier header (voir plus bas)
NSString *newValue = [comboBox stringValue];
// On vérifie si la valeur n'est pas déjà présente, auquel cas il n'y a
// rien à faire.
if ( [taskNameDataSource containsObject: newValue] == NO ) {
   NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
   // On va ajouter un élément à notre dataSource :
   // pour cela, il nous faut un NSMutableArray (NSArray étant en lecture seule)
   NSMutableArray *mutableDS = [NSMutableArray arrayWithArray: dataSource];
   // On ajoute la nouvelle valeur
   [mutableDS addObject: newValue];
   // On stocke le tout dans les User Defaults
   [defaults setValue: mutableDS forKey: @"ComboBoxValues"];
   // Et on met à jour la liste déroulante pour qu'elle prenne la nouvelle
   // valeur en compte (il y a peut-être mieux à faire ici).
   [self loadDataSource];
}

Enfin, voici un exemple de fichier header pour notre contrôleur principal :

@interface AppController : NSObject {
	IBOutlet NSComboBox* comboBox;
	NSArray *dataSource;
}
 
// Méthodes de gestion de la datasource pour la NSComboBox
- (int)numberOfItemsInComboBox:(NSComboBox *)aComboBox;
- (id)comboBox:(NSComboBox *)aComboBox objectValueForItemAtIndex:(int)index;

Une dernière chose : il est possible de voir les préférences d’une application depuis le Terminal, grâce à la commande suivante :

defaults read identifiant.de.votre.application

L’identifiant de votre application doit être unique et on le définit dans Xcode, dans les informations de la target : dans l’arborescence de Xcode, dans la section Targets, faites un clic droit sur votre target puis Get Info et enfin onglet Properties ; le champ à renseigner est… Tah daaah : Identifier. Utilisez un nom comme les packages Java : com.entreprise.application. Attention : les defaults sont généralement synchronisés et enregistrés sur le disque à la fermeture de l’application (ou avant, mais on ne sait pas quand) : il est donc possible de ne pas les voir tout de suite à jour dans le Terminal.

• la création du framework,
• l’utilisation du framework dans vos applications.

Création du framework

Dans Xcode, choisissez File > New Project… puis choisissez un projet de type Framework et plus précisément Cocoa Framework. Saisissez un joli nom pour votre framework. 

Faites un clic droit sur la target de votre framework puis choisissez Set Role > Public : ceci aura pour effet de copier les fichiers headers (.h) dans le framework, ce qui s’avère très utile pour utiliser ledit framework !

Éditez maintenant les propriétés de la target de votre framework (clic droit sur la target puis Get Info). Dans l’onglet Build, recherchez la section Deployment puis remplacez la valeur de la propriété Installation Directory par @executable_path/../Frameworks. Vous devriez avoir quelque chose qui ressemble à ceci :

Ajoutez ensuite toutes les classes et ressources à votre framework puis compilez le framework (Build). Rendez-vous dans le répertoire build de votre projet et vérifiez que vous avez bien un dossier avec l’extension .framework.

Utilisation du framework dans vos applications

Il y a deux choses importantes à faire ici :

• ajouter le framework à votre application (ce qui semble logique…),
• faire en sorte que ce framework se retrouve dans le dossier Frameworks à l’intérieur du bundle de votre application une fois votre application compilée.

Pour ajouter le framework à votre application, faites un clic droit sur la section Frameworks dans l’arborescence du projet puis Add > Existing Frameworks… puis parcourez votre disque à la recherche de votre framework (qui est un dossier à l’extension .framework, je vous le rappelle).

Pour la deuxième partie, faites un clic droit sur la target de votre application puis Add > New Build Phase > New Copy Files Build Phase.

Dans la boîte de dialogue, sélectionnez Frameworks pour le champ Destination et fermez la fenêtre (surtout qu’il fait froid en ce moment).

Enfin, dans l’arborescence du projet, faites glisser votre framework depuis la section Frameworks vers la nouvelle section Copy Files : vous devriez alors le voir apparaître en dessous et le libellé de la phase est maintenant Copy Files (1).

Dans votre application, vous devrez inclure les fichiers headers de vos classes de cette manière :

#import "nomDuFramework/Classe1.h"

Voilà, ça devrait marcher… amusez-vous bien !

Il faut créer une sous-classe de NSView, par exemple DropFilesView. Dans cette classe, il faut indiquer à Cocoa que cette vue accepte la dépose de fichiers par drag and drop. Pour cela, on implémente la méthode -awakeFromNib comme ceci :

- (void) awakeFromNib {
    [self registerForDraggedTypes:
     [NSArray arrayWithObjects: NSFilenamesPboardType, nil]
    ];
    // Attention à ne pas oublier le "nil" en dernier argument de
    // arrayWithObjects !
}

Je vous rappelle que la méthode -awakeFromNib est appelée automatiquement lorsque votre application est chargée par Cocoa : c’est donc un emplacement judicieux pour initialiser des données propres à la vue. Il faut ensuite implémenter les méthodes suivantes, en fonction des besoins :

- (NSDragOperation)draggingEntered:(id )sender {
    // Appelée UNE FOIS lorsque la souris commence à survoler la vue
    // dans un processus de drag and drop.
}
 
- (NSDragOperation)draggingExited:(id )sender {
    // Appelée lorsque la souris quitte la zone de survol de la vue
    // dans un processus de drag and drop.
}
 
- (NSDragOperation)draggingUpdated:(id )sender {
    // Appelée à chaque fois que la souris est déplacée au dessus de la vue
    // dans un processus de drag and drop.
}

Ces trois méthodes retournent toutes une valeur de type NSDragOperation, indiquant si la dépose est autorisée (NSDragOperationGeneric, …) ou pas (NSDragOperationNone). Ces méthodes peuvent donc servir à vérifier que la vue accepte bien les données qui sont sur le point d’être déposées, auquel cas on retourne une valeur autre que NSDragOperationNone ; si la dépose n’est pas permise, on retourne NSDragOperationNone.

Enfin, il faut gérer le cas où l’utilisateur dépose effectivement les fichiers, auquel cas la méthode -performDragOperation: est appelée : il convient donc de la surcharger à votre guise…

- (BOOL)performDragOperation:(id)sender {
    // Appelée lorsque l'utilisateur a déposer les fichiers sur la vue :
    // on doit alors récupérer la liste des fichiers et les traiter...
    NSPasteboard *pboard = [sender draggingPasteboard];
    if ( [[pboard types] containsObject:NSFilenamesPboardType] ) {
        NSArray *files = [pboard propertyListForType:NSFilenamesPboardType];
        // files contient maintenant la liste des fichiers (avec chemin complet)
        // qui ont été déposés sur la vue par l'utilisateur.
        // Faites donc ici ce que vous voulez avec files ;-)
    }
    return YES; // On indique que le drag and drop a été concluant.
}

Vous pouvez télécharger le projet complet pour Xcode : DropFilesTutorial.zip.

@implementation MyClass
// Déclaration d'une donnée membre STATIQUE
static NSDictionary* cacheMap;
...
@end

Pour initialiser cette variable, notamment s’il s’agit d’un objet, il suffit d’implémenter la méthode statique initialize de la classe concernée et d’y initialiser la donnée statique :

+ (void) initialize {
   cacheMap = [NSDisctionary dictionary];
}

Toutes les méthodes statiques de votre classe peuvent utiliser cette donnée statique : Cocoa se charge d’envoyer le message initialize à votre classe avant tout autre appel.

Attention : cette donnée statique ne sera pas visible dans les classes qui étendent votre classe.

De retour dans Xcode, ouvrez le fichier de déclaration de cette classe (GameView.h) et faites étendre la classe de NSView :

@interface GameView : NSView {
   NSImage *background;
}
@end

Ensuite, éditez le fichier d’implémentation de la classe (GameView.m) et implémentez la méthode -drawRect: :

- (void)awakeFromNib {
   // La variable "background" est déclarée dans le fichier header (.h).
   background = [NSImage imageNamed:@"background.png"];
}
 
- (void)drawRect:(NSRect)rect
{
   [background dissolveToPoint:NSMakePoint(0, 0) fraction:1.0];
}

Notez que l’image est initialisée dans la méthode -awakeFromNib, qui est appelée lors de l’initialisation de la vue.

Pour animer le contenu de la vue, et donc pour forcer le rafraîchissement de la vue, il est possible d’utiliser un NSTimer pour indiquer à la vue qu’elle doit se re-dessiner :

- (void)awakeFromNib {
   background = [NSImage imageNamed:@"background.png"];
   [NSTimer
      scheduledTimerWithTimeInterval:0.01
      target:self
      selector:@selector(refresh:)
      userInfo:nil
      repeats:YES];
}
 
- (void)refresh:(NSTimer*)timer {
   [self setNeedsDisplay:YES];
}

La méthode -refresh: sera appelée toutes les 0,01 seconde (100 fois par secondes, donc) et demandera à la vue de se re-dessiner, via l’appel à setNeedsDisplay:YES. Évidemment, ceci n’a de sens que si l’image (ou sa position) change.

Côté performances, j’ai fait quelques tests : j’affiche 1000 fois la même image (26×26 pixels) toutes les 0.01 seconde en la décalant de 1 pixel et ça ne gêne pas du tout mon iMac, l’animation est impeccable !

Je précise que ce n’est pas ici une technique très avancée pour animer du contenu, car cela ne tient pas compte de la puissance de la machine. En vérité, dans la méthode -refresh:, il faudrait vérifier si l’image doit être déplacée (ou modifiée) en fonction du temps qui s’est écoulé depuis la dernière modification de cette image. Ainsi, peu importe la résolution du timer utilisée, ou la capacité de la machine à afficher du contenu graphique, l’image sera toujours correcte (en fonction du temps écoulé), même si l’animation n’est pas fluide. Il est aussi possible d’utiliser NSAnimation pour des animations complexes « finies ».

Pour terminer, si votre but est de faire de l’animation complexe (2D ou 3D), comme pour la programmation d’un jeu, je ne peux que vous conseiller de vous tourner vers OpenGL. Je suis en train de m’y mettre, je publierai donc prochainement des articles à ce propos.