Bases d'iCloud et exemple de code
En tant que débutant, je me bats avec iCloud. Il y a quelques exemples, mais ils sont généralement assez détaillés (sur le forum des développeurs, il y en a un pour iCloud et CoreData qui est énorme). Les Apple docs sont OK, mais je ne vois toujours pas la vue d'ensemble. Alors, soyez indulgents, certaines de ces questions sont assez fondamentales, mais il est peut-être facile d'y répondre.
Contexte: J'ai une application iCloud très simple en cours d'exécution (exemple de code complet ci-dessous). Il n'y a qu'une seule UITextView affichée à l'utilisateur et son entrée est enregistrée dans un fichier appelé text.txt.
Le fichier txt est poussé vers le cloud et mis à la disposition de tous les appareils. Fonctionne parfaitement, mais:
Problème principal: qu'en est-il des utilisateurs qui n'utilisent pas iCloud?
Lorsque je lance mon application (voir le code ci-dessous), je vérifie si l'utilisateur a activé iCloud. Si iCloud est activé, tout va bien. L'application va de l'avant et recherche text.txt dans le cloud. S'il est trouvé, il le chargera et l'affichera à l'utilisateur. Si text.txt n'est pas trouvé dans le cloud, il créera simplement un nouveau text.txt et l'affichera à l'utilisateur.
Si l'utilisateur n'a pas activé iCloud, rien ne se passera. Comment vais-je permettre aux utilisateurs non-iCloud de continuer à travailler avec mon application de texte? Ou dois-je simplement les ignorer? Aurais-je besoin d'écrire des fonctions distinctes pour les utilisateurs non-iCloud? C'est à dire. fonctions dans lesquelles je charge simplement un text.txt à partir du dossier documents?
Traitez les fichiers dans iCloud de la même manière que vous traitez tous les autres fichiers dans votre sandbox d'application.
Cependant, dans mon cas, il n'y a plus de bac à sable d'application "normal". C'est dans le cloud. Ou dois-je toujours charger mon text.txt à partir du disque d'abord, puis vérifier avec iCloud s'il y a quelque chose de plus à jour?
Problème connexe: Structure des fichiers - Sandbox vs Cloud
Peut-être que mon principal problème est une incompréhension fondamentale de la façon dont iCloud est censé fonctionner. Lorsque je crée une nouvelle instance d'un UIDocument, je dois écraser deux méthodes. D'abord - (BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError **)outError pour récupérer les fichiers du cloud puis -(id)contentsForType:(NSString *)typeName error:(NSError **)outError pour récupérer les fichiers dans le cloud.
Dois-je incorporer des fonctions distinctes qui enregistreront également une copie locale de text.txt dans mon bac à sable? Est-ce que cela fonctionnera pour les utilisateurs non-iCloud? Si je comprends bien iCloud, il enregistrera automatiquement une copie locale de text.txt. Il ne devrait donc pas être nécessaire que j'enregistre quoi que ce soit dans le `` vieux '' bac à sable de mon application (c'est-à-dire comme c'était le cas à l'époque antérieure à iCloud). En ce moment, mon bac à sable est totalement vide, mais je ne sais pas si c'est correct. Dois-je conserver une autre copie de text.txt là-dedans? Cela ressemble à encombrer ma structure de données ... car il y a un text.txt dans le cloud, un dans le bac à sable iCloud sur mon appareil (qui fonctionnera même si je suis hors ligne), et un troisième dans le bon vieux bac à sable de mon application ...
MON CODE: un exemple de code iCloud simple
Ceci est vaguement basé sur un exemple que j'ai trouvé dans le forum des développeurs et sur la vidéo de la session WWDC. Je l'ai dépouillé au strict minimum. Je ne suis pas sûr que ma structure MVC soit bonne. Le modèle est dans l'AppDelegate, ce qui n'est pas idéal. Toutes suggestions pour l'améliorer sont les bienvenues.
EDIT: J'ai essayé d'extraire la question principale et je l'ai postée [ici] . 4
APERÇU:
Le bit le plus important qui charge le text.txt depuis le cloud:
// AppDelegate.h
// iCloudText
#import <UIKit/UIKit.h>
@class ViewController;
@class MyTextDocument;
@interface AppDelegate : UIResponder <UIApplicationDelegate> {
NSMetadataQuery *_query;
}
@property (strong, nonatomic) UIWindow *window;
@property (strong, nonatomic) ViewController *viewController;
@property (strong, nonatomic) MyTextDocument *document;
@end
// AppDelegate.m
// iCloudText
#import "AppDelegate.h"
#import "MyTextDocument.h"
#import "ViewController.h"
@implementation AppDelegate
@synthesize window = _window;
@synthesize viewController = _viewController;
@synthesize document = _document;
- (void)dealloc
{
[_window release];
[_viewController release];
[super dealloc];
}
- (void)loadData:(NSMetadataQuery *)query {
// (4) iCloud: the heart of the load mechanism: if texts was found, open it and put it into _document; if not create it an then put it into _document
if ([query resultCount] == 1) {
// found the file in iCloud
NSMetadataItem *item = [query resultAtIndex:0];
NSURL *url = [item valueForAttribute:NSMetadataItemURLKey];
MyTextDocument *doc = [[MyTextDocument alloc] initWithFileURL:url];
//_document = doc;
doc.delegate = self.viewController;
self.viewController.document = doc;
[doc openWithCompletionHandler:^(BOOL success) {
if (success) {
NSLog(@"AppDelegate: existing document opened from iCloud");
} else {
NSLog(@"AppDelegate: existing document failed to open from iCloud");
}
}];
} else {
// Nothing in iCloud: create a container for file and give it URL
NSLog(@"AppDelegate: ocument not found in iCloud.");
NSURL *ubiq = [[NSFileManager defaultManager] URLForUbiquityContainerIdentifier:nil];
NSURL *ubiquitousPackage = [[ubiq URLByAppendingPathComponent:@"Documents"] URLByAppendingPathComponent:@"text.txt"];
MyTextDocument *doc = [[MyTextDocument alloc] initWithFileURL:ubiquitousPackage];
//_document = doc;
doc.delegate = self.viewController;
self.viewController.document = doc;
[doc saveToURL:[doc fileURL] forSaveOperation:UIDocumentSaveForCreating completionHandler:^(BOOL success) {
NSLog(@"AppDelegate: new document save to iCloud");
[doc openWithCompletionHandler:^(BOOL success) {
NSLog(@"AppDelegate: new document opened from iCloud");
}];
}];
}
}
- (void)queryDidFinishGathering:(NSNotification *)notification {
// (3) if Query is finished, this will send the result (i.e. either it found our text.dat or it didn't) to the next function
NSMetadataQuery *query = [notification object];
[query disableUpdates];
[query stopQuery];
[self loadData:query];
[[NSNotificationCenter defaultCenter] removeObserver:self name:NSMetadataQueryDidFinishGatheringNotification object:query];
_query = nil; // we're done with it
}
-(void)loadDocument {
// (2) iCloud query: Looks if there exists a file called text.txt in the cloud
NSMetadataQuery *query = [[NSMetadataQuery alloc] init];
_query = query;
//SCOPE
[query setSearchScopes:[NSArray arrayWithObject:NSMetadataQueryUbiquitousDocumentsScope]];
//PREDICATE
NSPredicate *pred = [NSPredicate predicateWithFormat: @"%K == %@", NSMetadataItemFSNameKey, @"text.txt"];
[query setPredicate:pred];
//FINISHED?
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(queryDidFinishGathering:) name:NSMetadataQueryDidFinishGatheringNotification object:query];
[query startQuery];
}
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
NSLog(@"AppDelegate: app did finish launching");
self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];
// Override point for customization after application launch.
if ([[UIDevice currentDevice] userInterfaceIdiom] == UIUserInterfaceIdiomPhone) {
self.viewController = [[[ViewController alloc] initWithNibName:@"ViewController_iPhone" bundle:nil] autorelease];
} else {
self.viewController = [[[ViewController alloc] initWithNibName:@"ViewController_iPad" bundle:nil] autorelease];
}
self.window.rootViewController = self.viewController;
[self.window makeKeyAndVisible];
// (1) iCloud: init
NSURL *ubiq = [[NSFileManager defaultManager] URLForUbiquityContainerIdentifier:nil];
if (ubiq) {
NSLog(@"AppDelegate: iCloud access!");
[self loadDocument];
} else {
NSLog(@"AppDelegate: No iCloud access (either you are using simulator or, if you are on your phone, you should check settings");
}
return YES;
}
@end
Le document UID
// MyTextDocument.h
// iCloudText
#import <Foundation/Foundation.h>
#import "ViewController.h"
@interface MyTextDocument : UIDocument {
NSString *documentText;
id delegate;
}
@property (nonatomic, retain) NSString *documentText;
@property (nonatomic, assign) id delegate;
@end
// MyTextDocument.m
// iCloudText
#import "MyTextDocument.h"
#import "ViewController.h"
@implementation MyTextDocument
@synthesize documentText = _text;
@synthesize delegate = _delegate;
// ** READING **
- (BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError **)outError
{
NSLog(@"UIDocument: loadFromContents: state = %d, typeName=%@", self.documentState, typeName);
if ([contents length] > 0) {
self.documentText = [[NSString alloc] initWithBytes:[contents bytes] length:[contents length] encoding:NSUTF8StringEncoding];
}
else {
self.documentText = @"";
}
NSLog(@"UIDocument: Loaded the following text from the cloud: %@", self.documentText);
// update textView in delegate...
if ([_delegate respondsToSelector:@selector(noteDocumentContentsUpdated:)]) {
[_delegate noteDocumentContentsUpdated:self];
}
return YES;
}
// ** WRITING **
-(id)contentsForType:(NSString *)typeName error:(NSError **)outError
{
if ([self.documentText length] == 0) {
self.documentText = @"New Note";
}
NSLog(@"UIDocument: Will save the following text in the cloud: %@", self.documentText);
return [NSData dataWithBytes:[self.documentText UTF8String] length:[self.documentText length]];
}
@end
LE VIEWCONTROLLER
//
// ViewController.h
// iCloudText
#import <UIKit/UIKit.h>
@class MyTextDocument;
@interface ViewController : UIViewController <UITextViewDelegate> {
IBOutlet UITextView *textView;
}
@property (nonatomic, retain) UITextView *textView;
@property (strong, nonatomic) MyTextDocument *document;
-(void)noteDocumentContentsUpdated:(MyTextDocument *)noteDocument;
@end
// ViewController.m
// iCloudText
#import "ViewController.h"
#import "MyTextDocument.h"
@implementation ViewController
@synthesize textView = _textView;
@synthesize document = _document;
-(IBAction)dismissKeyboard:(id)sender {
[_textView resignFirstResponder];
}
-(void)noteDocumentContentsUpdated:(MyTextDocument *)noteDocument
{
NSLog(@"VC: noteDocumentsUpdated");
_textView.text = noteDocument.documentText;
}
-(void)textViewDidChange:(UITextView *)theTextView {
NSLog(@"VC: textViewDidChange");
_document.documentText = theTextView.text;
[_document updateChangeCount:UIDocumentChangeDone];
}
Je viens de relire les documents et il semble que mon approche générale soit erronée. Je dois d'abord créer le fichier dans le bac à sable, puis le déplacer vers le cloud. En d'autres termes, Apple semble suggérer que je devrais avoir trois versions du même fichier à tout moment: une dans le répertoire de mon application, une dans le répertoire démon iCloud de mon appareil (qui est également accessible en mode hors connexion) et un dans le cloud:
Les applications utilisent les mêmes technologies pour gérer les fichiers et répertoires dans iCloud que pour les fichiers et répertoires locaux. Les fichiers et répertoires dans iCloud ne sont encore que des fichiers et des répertoires. Vous pouvez les ouvrir, les créer, les déplacer, les copier , lisez-les et écrivez-les, supprimez-les ou toute autre opération que vous pourriez souhaiter effectuer. La seule différence entre les fichiers et répertoires locaux et les fichiers et répertoires iCloud est l'URL que vous utilisez pour y accéder. Au lieu que les URL soient relatives à le sandbox de votre application, les URL des fichiers et répertoires iCloud sont relatives au répertoire conteneur iCloud correspondant.
Pour déplacer un fichier ou un répertoire vers iCloud:
Créez le fichier ou le répertoire localement dans votre sandbox d'application. Lorsqu'il est utilisé, le fichier ou le répertoire doit être géré par un présentateur de fichier, tel qu'un objet UIDocument.
Utilisez la méthode URLForUbiquityContainerIdentifier: pour récupérer une URL pour le répertoire du conteneur iCloud dans lequel vous souhaitez stocker l'élément. Utilisez l'URL du répertoire de conteneurs pour créer une nouvelle URL qui spécifie l'emplacement de l'élément dans iCloud. Appelez la méthode setUbiquitous: itemAtURL: destinationURL: error: de NSFileManager pour déplacer l'élément vers iCloud. N'appelez jamais cette méthode à partir du thread principal de votre application; cela pourrait bloquer votre thread principal pendant une période prolongée ou provoquer un blocage avec l'un des propres présentateurs de fichiers de votre application. Lorsque vous déplacez un fichier ou un répertoire vers iCloud, le système copie cet élément hors de votre sandbox d'application et dans un répertoire local privé afin qu'il puisse être surveillé par le démon iCloud. Même si le fichier n'est plus dans votre bac à sable, votre application y a toujours un accès complet. Bien qu'une copie du fichier reste locale sur le périphérique actuel, le fichier est également envoyé à iCloud afin qu'il puisse être distribué à d'autres périphériques. Le démon iCloud gère tout le travail pour s'assurer que les copies locales sont les mêmes. Du point de vue de votre application, le fichier est simplement dans iCloud.
Toutes les modifications que vous apportez à un fichier ou un répertoire dans iCloud doivent être effectuées à l'aide d'un objet coordinateur de fichiers. Ces modifications incluent le déplacement, la suppression, la copie ou le changement de nom de l'élément. Le coordinateur de fichiers garantit que le démon iCloud ne modifie pas le fichier ou le répertoire en même temps et s'assure que les autres parties intéressées sont informées des modifications que vous apportez.
Cependant, si vous approfondissez un peu les documents concernant setUbiquitous, vous trouverez:
Utilisez cette méthode pour déplacer un fichier de son emplacement actuel vers iCloud. Pour les fichiers situés dans le sandbox d'une application, cela implique de supprimer physiquement le fichier du répertoire sandbox. (Le système étend les privilèges du bac à sable de votre application pour lui donner accès aux fichiers qu'elle déplace vers iCloud.) Vous pouvez également utiliser cette méthode pour déplacer des fichiers hors d'iCloud et les replacer dans un répertoire local.
Cela semble donc signifier qu'un fichier/répertoire est supprimé du sandbox local et déplacé dans le cloud.
J'ai utilisé votre exemple et je l'aime pour m'aider à comprendre les bases d'iCloud. Maintenant, je me débat avec votre question pour ma propre application qui doit prendre en charge les utilisateurs existants de l'application avec du contenu stocké localement qui peuvent ou non utiliser iCloud en créant ces cas pour autant que je sache:
Cas:
- Nouvel utilisateur
- a icloud - créer des documents dans icloud
- no icloud - créer des documents localement
- Utilisateur existant
- a icloud
- vient d'être ajouté - migrer les documents locaux vers icloud
- pas seulement ajouté - ouvrir/enregistrer des documents sur icloud
- aucun icloud
- vient d'être supprimé - migrer d'anciens documents icloud vers le local
- pas seulement supprimé - ouvrir/enregistrer des documents sur le site local
- a icloud
Si quelqu'un supprime iCloud - les appels à l'URL omniprésente ne retourneraient-ils aucun? Si tel est le cas, comment puis-je migrer les documents vers le stockage local? Je vais créer une préférence utilisateur pour l'instant, mais cela semble un peu une solution de contournement.
Je sens que je manque quelque chose d'évident ici, donc si quelqu'un peut le voir, veuillez sonner.
Si vous voulez que les utilisateurs puissent partager du texte entre des appareils pré-iOS 5.0, vous devrez faire ce que tout le monde devait faire avant iCloud et déplacer les informations vers votre propre serveur.
Tout ce dont vous avez vraiment besoin, c'est d'un serveur quelque part qui permet à votre application d'enregistrer ses fichiers texte et de les associer à un compte d'utilisateur.
Vous aurez besoin d'utilisateurs pour créer un compte et vous devrez gérer le processus vous-même, de déplacer de nouvelles informations sur un appareil dans votre propre "cloud".
Les utilisateurs s'inscriront avec le même compte sur d'autres appareils et vous devrez prendre soin de détecter quand un autre appareil a déplacé des données vers votre propre cloud et mettre à jour l'appareil actuel avec les nouvelles informations.
De toute évidence, pour les appareils iOS 5.0, vous voudrez probablement détecter les fichiers modifiés pour les appareils pré-iOS 5.0 dans votre propre cloud, et également pouvoir parler à iCloud.
Il ne semble pas que vous rencontrez autant de problèmes avec iCloud/notICloud qu'avec iOS5/notIOS5.
Si votre cible de déploiement est iOS5, utilisez simplement toujours la structure UIDocument. S'il est omniprésent, votre NSMetaDataQuery le trouvera dans le cloud; sinon, il le trouvera sur l'appareil.
Si, d'autre part, vous souhaitez fournir un accès pré 5.0 à votre application, vous devrez vérifier conditionnellement si iOS en cours d'exécution est 5.0 ou supérieur. Si c'est le cas, utilisez UIDocument; sinon, lisez/écrivez les données à l'ancienne.
Mon approche consistait à écrire une méthode saveData conditionnelle qui vérifie iOS5. S'il existe, je mets à jour le nombre de modifications (ou j'utilise un gestionnaire d'annulation). Dans votre cas, textViewDidChange appellera cette méthode. Sinon, il enregistre sur le disque à l'ancienne. Au chargement, l'inverse se produit.
Vous êtes embrouillé par "Traitez les fichiers dans iCloud de la même manière que vous traitez tous les autres fichiers dans votre sandbox d'application". Cela vaut pour quelque chose comme Keynote et Numbers où vous conservez un tas de fichiers, et si vous avez iCloud, ils commencent à se synchroniser comme par magie.
Cependant, vous créez quelque chose qui dépend des fonctionnalités de type iCloud. Vous ne pouvez pas conserver cette déclaration, car votre application dépend de la présence d'iCloud pour que tout fonctionne comme prévu. Vous devrez soit fermer votre application et simplement dire "veuillez configurer iCloud pour que cela fonctionne" ou dupliquer des fonctionnalités de type iCloud (la vôtre ou celle de quelqu'un d'autre) que vous pouvez toujours utiliser, indépendamment.