iCloud-Helper

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 67 Open GitHub ↗

Simple iCloud file managment. Read, write, load, list files across devices.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

iCloud-Helper
=============

Simple **iCloud file managment**.  
Read, write, load, list files across devices, easily.

Before starting, please read **Apple official reference**:
<https://developer.apple.com/icloud/documentation/>

## Requirements

- A valid Provisioning Profile ( with iCloud access )
- An iCloud account
- iOS 5.1+
- ARC / Non ARC
- iOS device
- Security.framework

---

## Configuration

Copy these files to your project:

APCloudCore.h
	APCloudCore.m
	APCloudDocument.h
	APCloudDocument.m
	APCloudFileSystem.h
	APCloudFileSystem.m
	APCloudData.h
	APCloudData.m
	NSString+MD5.h
	NSString+MD5.m
	
and import `Security.framework` to your project.

---

### Screenshots

![SS Screenshot](https://raw.githubusercontent.com/elpsk/iCloud-Helper/master/a.png "SS")
![SS Screenshot](https://raw.githubusercontent.com/elpsk/iCloud-Helper/master/b.png "SS")  
![SS Screenshot](https://raw.githubusercontent.com/elpsk/iCloud-Helper/master/c.png "SS")

## How to use

Import `#import "APCloudCore.h"` in your project.

Next, set your `delegate`, and your `file prefix`.  
File prefix, is very important if you want to separate files, because iCloud don't permit to create and read folders.

Every classes provides a singleton access.

[[APCloudCore sharedCloud] setDelegate:self];
	[[APCloudCore sharedCloud] setFilePrefix:@"ap"];

---

#### Methods:
###### Check for cloud enabled

[[APCloudCore sharedCloud] isCloudEnabled];
	
###### Save a file

[[APCloudCore sharedCloud] saveData:yourData withName:yourFileName];

###### Load a file

[[APCloudCore sharedCloud] loadDataWithName:yourFileName];

###### Delete a file

[[APCloudCore sharedCloud] deleteFileWithName:yourFileName];

###### Load all cloud files

[[APCloudCore sharedCloud] loadAllFilesWithPrefix:yourPrefix];

---

### APCloudCoreDelegate

If you're implemented the `optionals` delegate, you should implements the delegates (*finish* and *fail*):

- (void) apCloudCoreDidFinishUpdate;
	- (void) apCloudCoreDidFailUpdate;
	
	- (void) apCloudCoreDidFinishLoadFiles:(NSMutableArray*)file;
	- (void) apCloudCoreDidFailLoadFiles;
	
	- (void) apCloudCoreDidFinishSaveData:(id)data;
	- (void) apCloudCoreDidFailSaveData:(id)data;
	
	- (void) apCloudCoreDidFinishLoadData:(id)data;
	- (void) apCloudCoreDidFailLoadData:(id)data;
	
	- (void) apCloudCoreDidFinishDeleteData:(id)data;
	- (void) apCloudCoreDidFailDeleteData:(id)data;

---

### Notes on SAVE
Save method, accept an `id` as file. This id is your custom class, that **must** implements `NSCoding` protocol.

Example of test store class:

```
@interface APTestStore : NSObject <NSCoding>

@property (nonatomic, strong) NSString *aTitle;
@property (nonatomic, strong) NSString *aSubTitle;
@property (nonatomic, strong) NSString *aDescription;

@end

@implementation APTestStore
@end
```

This class is saved (encrypted) and loaded (decrypted) to/from cloud as `NSData`.

###### Cloud files
File are stored in your Cloud directory, that is accessibile from web, at url  <http://developer.icloud.com> or in your Mac local folder, `~/Library/Mobile Documents/`.
	
Files are stored using this tree:

~/Library/Mobile Documents/XXXXXXX~it~albertopasca~dev-app/Documents/

ap_test-file-1.dat
	ap_test-file-2.dat
	ap_test-file-3.dat
	xx-afile-1.dat
	xx-afile-2.dat
	[...]
	
"*ap*" or "*xx*" are the **prefixes** of your files!

Have fun.

iCloud-Helper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README