Aujourd’hui, les frameworks sont devenus incontournables. Il en existe dans chaque langage de programmation (même dans le CSS). Il en va de même pour l’iPhone.

Même si le SDK de l’iPhone fournit déjà des frameworks officiels pour faciliter la gestion du son, la géolocalisation et bien d’autres choses. Il existe aussi des frameworks indépendants qui fournissent des composants graphiques et divers utilitaires. C’est le cas de celui qu’on utilise : Three20.

Three20 is a collection of iPhone UI classes, like a photo viewer, and general utilities, like an HTTP disk cache. Three20 is derived from the Facebook iPhone app, which is one of the most downloaded iPhone apps ever.

Nous aimons particulièrement sa fonctionnalité de navigation par URL, le principe est similaire à symfony et son routing. Nous définissons des routes et lorsqu’on les appelle, le framework instancie notre classe, la rajoute dans la navigation puis l’affiche. L’avantage est qu’il s’occupe automatiquement de la navigation et la pile d’écrans, choses assez redondantes. Il fournit aussi un mécanisme pour mettre en cache le dernier écran vu sur l’application pour pouvoir l’afficher à nouveau lors de la réouverture de l’application, la navigation devient donc persistante automatiquement (oui il faut écrire la ligne de code pour activer la persistance encore ).

Prenons un exemple, imaginons que nous avons une liste de références et une page de détail. Sans framework, il faut définir de manière explicite tout le processus pour l’afficher. Dans l’ordre, on crée donc notre contrôleur, on le « push » à notre navigationController…etc. Ce n’est pas spécialement long mais c’est très redondant. En revanche, avec une navigation par URL, on ne fait plus ce genre de choses, et on découple (un peu) les classes entre elles.

Voyons plus en détail comme ça fonctionne :

Comme dans symfony, il faut au préalable déclarer nos routes ; ici, c’est dans notre fichier XXAppDelegate.m qu’on le fait :

- (void)applicationDidFinishLaunching:(UIApplication*)application {
    TTNavigator* navigator = [TTNavigator navigator];
    navigator.persistenceMode = TTNavigatorPersistenceModeTop;
    navigator.window = [[[UIWindow alloc] initWithFrame:TTScreenBounds()] autorelease];
    TTURLMap* map = navigator.URLMap;
    [map from:@"tt://pageReference" toSharedViewController:[ReferenceController class]];
}

Noter que nous venons de remplacer l’écran principal de l’application par le navigateur de Three20 donc si on compile à ce moment précis, nous obtenons une page noire puisque nous n’avons lancé aucune URL comme première page.

Pour lancer une URL, rien de plus simple. Il faut simplement appeler la méthode « openURLAction sur notre objet navigateur.

if (![navigator restoreViewControllers]) {
    [navigator openURLAction:[TTURLAction actionWithURLPath:@"tt://pageReference"]];
}

Cet objet étant un singleton, nous pouvons faire la même chose partout à travers l’application comme ceci :

[[TTNavigator  navigator] openURLAction:[[TTURLAction actionWithURLPath:@"tt://pageReference"] applyAnimated:YES]];

On peut évidemment passer des paramètres à ces routes afin de définir le constructeur (appelé par défaut « init »).Le plus fort, c’est que tout nos objets peuvent même être transformer/mapper en route très facilement ! Si on veut avoir une route unique pour accéder à la page de détail, nous définissons une route (1), on mappe l’objet sur la route (2) et lorsque l’on veut utiliser cette route ça devient encore plus simple (3).

// 1 : route principale
[map from:@"tt://reference-detail/(initWithObject:)" toViewController:[ReferenceDetailController class]];

// 2 : mappage de l'objet sur la route, ici (uid) est une propriété de notre objet.
[map from:[WebObject class] name:@"reference" toURL:@"tt://reference-detail/(uid))"];

// 3 : utilisation
WebObject *t = [[WebObject alloc] initWithUid:123];
NSString * url = [t URLValueWithName:@"detail"];

NSLog(t); // affiche : tt://reference-detail/123
[[TTNavigator  navigator] openURLAction:[[TTURLAction actionWithURLPath:url] applyAnimated:YES]];

Vous notez l’existence de la méthode URLValueWithName qui retourne la bonne url. En fait, nous n’avons pas eu à la créer vu qu’elle est ajouté automatiquement par Three20 sur tous nos objets grâce au merveilleux système de « catégorie ». Les catégories en Objective C permettent d’ajouter dynamiquement des méthodes à n’importe quelle classe sans devoir l’étendre comme dans la plupart des langages ! Ici Three20 a du rajouter une catégorie sur NSObject.

Nous venons de faire un rapide tour sur la navigation par URL. Pour en savoir plus, la documentation officielle est disponible ici : http://three20.info/ui/navigation

Related posts:

1. Three20 pour créer un menu intelligent avec TTTabStrip
2. iPhone OS4 – gestion des images

  1 Commentaire     Partager