основы iCloud и пример кода [закрыт]

как новичок, я борюсь с iCloud. Есть несколько примеров, но они обычно довольно подробные (на форуме разработчиков есть один для iCloud и CoreData, который является массивным). Элемент apple docs в порядке, но я все еще не вижу общей картины. Поэтому, пожалуйста, потерпите меня, некоторые из этих вопросов довольно фундаментальны, но, возможно, легко ответить.

контекст: у меня есть очень простое приложение iCloud (полный пример кода ниже). Есть только один UITextView отображается пользователю, и его / ее ввод сохраняется в файле с именем text.формат txt.

файл txt помещается в облако и становится доступным для всех устройств. Работает отлично, но:

основная проблема: как насчет пользователей, которые не используют iCloud?

когда я запускаю свое приложение (см. код ниже), я проверяю, включен ли у пользователя iCloud. Если iCloud включен, все в порядке. Приложение идет вперед и ищет текст.txt in облако. Если он будет найден, он загрузит его и отобразит его пользователю. Если текст.txt не найден в облаке, он просто создаст новый текст.txt и покажет это пользователю.

если у пользователя не включен iCloud, ничего не произойдет. Как я могу сделать так, чтобы пользователи, не являющиеся пользователями iCloud, все еще могли работать с моим текстовым приложением? Или я просто игнорирую их? Нужно ли мне писать отдельные функции для пользователей, отличных от iCloud? Т. е. функции, в которые я просто загружаю текст.txt из документов папка?

Apple пишет:

обрабатывайте файлы в iCloud так же, как вы обрабатываете все другие файлы в песочнице вашего приложения.

однако в моем случае больше нет "нормальной" песочницы приложений. Это в облаке. Или я всегда загружаю свой текст.сначала txt с диска, а затем проверить с iCloud, если есть что-то более современное?

связанная проблема: структура файла-песочница против Облако

возможно, моя главная проблема заключается в фундаментальном непонимании того, как iCloud должен работать. Когда я создаю новый экземпляр UIDocument, мне придется перезаписать два метода. Первый - (BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError **)outError чтобы получить файлы из облака, а потом -(id)contentsForType:(NSString *)typeName error:(NSError **)outError чтобы получить файлы в облаке.

должен ли я включать отдельные функции, которые также сохранят локальную копию текста.txt в мою песочницу? Будет ли это работать для пользователей, отличных от iCloud? Как я понимаю iCloud, он сохранит локальная копия текста.тхт автоматически. Поэтому мне не нужно ничего сохранять в "старой" песочнице моего приложения (т. е. так, как это было в старые, предшествующие iCloud дни). Сейчас моя песочница совершенно пуста, но я не знаю, правильно ли это. Я должен сохранить еще одну копию текста.txt там? Это похоже на загромождение моей структуры данных... так же есть один текст.txt в облаке, один в песочнице iCloud на устройстве (который будет работать даже если я оффлайн), а третий в хорошем старая песочница моего приложения...

мой код: простой пример кода iCloud

это свободно основано на примере, который я нашел на форуме разработчиков и на видео сеанса WWDC. Я раздел его до минимума. Я не уверен, что моя структура MVC хороша. Модель находится в AppDelegate, который не является идеальным. Любые предложения, чтобы сделать его лучше приветствуются.

EDIT: я попытался извлечь основной вопрос и разместил его [здесь.]4

описание:

самый важный бит, который загружает текст.текст из облака:

//  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

UIDocument

//  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

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];



}