Skip to content

Commit

Permalink
Version 7.1
Browse files Browse the repository at this point in the history
Updated init method, fixed double-init of singleton, fixed bug when saving documents, new delegate method, fixed ubiquity URL bugs
  • Loading branch information
iRare Media committed Dec 4, 2013
1 parent 4299f0e commit eb52599
Show file tree
Hide file tree
Showing 42 changed files with 385 additions and 458 deletions.
Expand Up @@ -282,8 +282,8 @@ <h1 class="title title-header">iCloud Class Reference</h1>
</tr>
</tbody></table></div>


<div class="section section-overview">
<a title="Overview" name="overview"></a>
Expand Down Expand Up @@ -323,6 +323,7 @@ <h3 class="subsubtitle task-title">Singleton</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/sharedCloud">+&nbsp;sharedCloud</a></code>
<span class="tooltip"><p>iCloud shared instance object</p></span>
</span>


Expand All @@ -337,6 +338,7 @@ <h3 class="subsubtitle task-title">Delegate</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/delegate">&nbsp;&nbsp;delegate</a></code>
<span class="tooltip"><p>iCloud Delegate helps call methods when document processes begin or end</p></span>
</span>
<span class="task-item-suffix">property</span>

Expand All @@ -351,30 +353,35 @@ <h3 class="subsubtitle task-title">Properties</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/query">&nbsp;&nbsp;query</a></code>
<span class="tooltip"><p>The current NSMetadataQuery object</p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/fileList">&nbsp;&nbsp;fileList</a></code>
<span class="tooltip"><p>A list of iCloud files from the current <a href="#//api/name/query">query</a></p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/previousQueryResults">&nbsp;&nbsp;previousQueryResults</a></code>
<span class="tooltip"><p>A list of iCloud files from the previous <a href="#//api/name/query">query</a></p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/verboseLogging">&nbsp;&nbsp;verboseLogging</a></code>
<span class="tooltip"><p>Enable verbose logging for detailed feedback in the log. Turning this off only prints crucial log notes such as errors.</p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/verboseAvailabilityLogging">&nbsp;&nbsp;verboseAvailabilityLogging</a></code>
<span class="tooltip"><p>Enable verbose availability logging for repeated feedback about iCloud availability in the log. Turning this off will prevent availability-related messages from being printed in the log. This property does not relate to the <a href="#//api/name/verboseLogging">verboseLogging</a> property.</p></span>
</span>
<span class="task-item-suffix">property</span>

Expand All @@ -389,24 +396,28 @@ <h3 class="subsubtitle task-title">Checking for iCloud</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/checkCloudAvailability">&ndash;&nbsp;checkCloudAvailability</a></code>
<span class="tooltip"><p>Check whether or not iCloud is available and that it can be accessed. Returns a boolean value.</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/checkCloudUbiquityContainer">&ndash;&nbsp;checkCloudUbiquityContainer</a></code>
<span class="tooltip"><p>Check that the current application&rsquo;s iCloud Ubiquity Container is available. Returns a boolean value.</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/ubiquitousContainerURL">&ndash;&nbsp;ubiquitousContainerURL</a></code>
<span class="tooltip"><p>Retrieve the current application&rsquo;s ubiquitous root URL</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/ubiquitousDocumentsDirectoryURL">&ndash;&nbsp;ubiquitousDocumentsDirectoryURL</a></code>
<span class="tooltip"><p>Retrieve the current application&rsquo;s ubiquitous documents directory URL</p></span>
</span>


Expand All @@ -421,6 +432,7 @@ <h3 class="subsubtitle task-title">Syncing with iCloud</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/updateFiles">&ndash;&nbsp;updateFiles</a></code>
<span class="tooltip"><p>Check for and update the list of files stored in your app&rsquo;s iCloud Documents Folder. This method is automatically called by iOS when there are changes to files in the iCloud Directory. The iCloudFilesDidChange:withNewFileNames: <a href="#//api/name/delegate">delegate</a> method is triggered by this method.</p></span>
</span>


Expand All @@ -435,24 +447,21 @@ <h3 class="subsubtitle task-title">Uploading to iCloud</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">&ndash;&nbsp;saveAndCloseDocumentWithName:withContent:completion:</a></code>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/saveChangesToDocumentWithName:withContent:completion:">&ndash;&nbsp;saveChangesToDocumentWithName:withContent:completion:</a></code>
<span class="tooltip"><p>Create, save, and close a document in iCloud.</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/uploadLocalOfflineDocumentsWithRepeatingHandler:completion:">&ndash;&nbsp;uploadLocalOfflineDocumentsWithRepeatingHandler:completion:</a></code>
<span class="tooltip"><p>Upload any local files that weren&rsquo;t created with iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/uploadLocalDocumentToCloudWithName:completion:">&ndash;&nbsp;uploadLocalDocumentToCloudWithName:completion:</a></code>
<span class="tooltip"><p>Upload a local file to iCloud</p></span>
</span>


Expand All @@ -467,6 +476,7 @@ <h3 class="subsubtitle task-title">Sharing iCloud Content</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/shareDocumentWithName:completion:">&ndash;&nbsp;shareDocumentWithName:completion:</a></code>
<span class="tooltip"><p>Share an iCloud document by uploading it to a public URL.</p></span>
</span>


Expand All @@ -481,12 +491,14 @@ <h3 class="subsubtitle task-title">Deleting iCloud Content</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/deleteDocumentWithName:completion:">&ndash;&nbsp;deleteDocumentWithName:completion:</a></code>
<span class="tooltip"><p>Delete a document from iCloud.</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/evictCloudDocumentWithName:completion:">&ndash;&nbsp;evictCloudDocumentWithName:completion:</a></code>
<span class="tooltip"><p>Evict a document from iCloud, move it from iCloud to the current application&rsquo;s local documents directory.</p></span>
</span>


Expand All @@ -501,42 +513,49 @@ <h3 class="subsubtitle task-title">Retrieving iCloud Content and Info</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/retrieveCloudDocumentWithName:completion:">&ndash;&nbsp;retrieveCloudDocumentWithName:completion:</a></code>
<span class="tooltip"><p>Open a UIDocument stored in iCloud. If the document does not exist, a new blank document will be created using the documentName provided. You can use the <a href="#//api/name/doesFileExistInCloud:">doesFileExistInCloud:</a> method to check if a file exists before calling this method.</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/retrieveCloudDocumentObjectWithName:">&ndash;&nbsp;retrieveCloudDocumentObjectWithName:</a></code>
<span class="tooltip"><p>Get the relevant <a href="../Classes/iCloudDocument.html">iCloudDocument</a> object for the specified file</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/doesFileExistInCloud:">&ndash;&nbsp;doesFileExistInCloud:</a></code>
<span class="tooltip"><p>Check if a file exists in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/fileSize:">&ndash;&nbsp;fileSize:</a></code>
<span class="tooltip"><p>Get the size of a file stored in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/fileModifiedDate:">&ndash;&nbsp;fileModifiedDate:</a></code>
<span class="tooltip"><p>Get the last modified date of a file stored in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/fileCreatedDate:">&ndash;&nbsp;fileCreatedDate:</a></code>
<span class="tooltip"><p>Get the creation date of a file stored in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/getListOfCloudFiles">&ndash;&nbsp;getListOfCloudFiles</a></code>
<span class="tooltip"><p>Get a list of files stored in iCloud</p></span>
</span>


Expand All @@ -551,12 +570,14 @@ <h3 class="subsubtitle task-title">Managing iCloud Content</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/renameOriginalDocument:withNewName:completion:">&ndash;&nbsp;renameOriginalDocument:withNewName:completion:</a></code>
<span class="tooltip"><p>Rename a document in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/duplicateOriginalDocument:withNewName:completion:">&ndash;&nbsp;duplicateOriginalDocument:withNewName:completion:</a></code>
<span class="tooltip"><p>Duplicate a document in iCloud</p></span>
</span>


Expand All @@ -571,18 +592,21 @@ <h3 class="subsubtitle task-title">iCloud Document State</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/documentStateForFile:completion:">&ndash;&nbsp;documentStateForFile:completion:</a></code>
<span class="tooltip"><p>Get the current document state of a file stored in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/monitorDocumentStateForFile:onTarget:withSelector:">&ndash;&nbsp;monitorDocumentStateForFile:onTarget:withSelector:</a></code>
<span class="tooltip"><p>Monitor changes in the state of a document stored in iCloud</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/stopMonitoringDocumentStateChangesForFile:onTarget:">&ndash;&nbsp;stopMonitoringDocumentStateChangesForFile:onTarget:</a></code>
<span class="tooltip"><p>Stop monitoring changes to the state of a document stored in iCloud</p></span>
</span>


Expand All @@ -597,12 +621,21 @@ <h3 class="subsubtitle task-title">Resolving iCloud Conflicts</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/findUnresolvedConflictingVersionsOfFile:">&ndash;&nbsp;findUnresolvedConflictingVersionsOfFile:</a></code>
<span class="tooltip"><p>Find all the conflicting versions of a specified document</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/resolveConflictForFile:withSelectedFileVersion:">&ndash;&nbsp;resolveConflictForFile:withSelectedFileVersion:</a></code>
<span class="tooltip"><p>Your application can follow one of three strategies for resolving document-version conflicts:</p>

<ul>
<li>Merge the changes from the conflicting versions.</li>
<li>Choose one of the document versions based on some pertinent factor, such as the version with the latest modification date.</li>
<li>Enable the user to view conflicting versions of a document and select the one to use.</li>
</ul>
</span>
</span>


Expand All @@ -615,14 +648,23 @@ <h3 class="subsubtitle task-title">Deprecated Methods</h3>

<ul class="task-list">
<li>
<span class="tooltip">
<code><a href="#//api/name/saveChangesToDocumentWithName:withContent:completion:">&ndash;&nbsp;saveChangesToDocumentWithName:withContent:completion:</a></code>
<span class="tooltip"><p>DEPRECATED. Use <a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">saveAndCloseDocumentWithName:withContent:completion:</a> instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated beginning in version 7.1. Use saveAndCloseDocumentWithName:withContent:completion: instead. This method may become unavailable in a future version.</span>)</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/uploadLocalOfflineDocumentsWithDelegate:">+&nbsp;uploadLocalOfflineDocumentsWithDelegate:</a></code>
<span class="tooltip"><p>DEPRECATED. Use uploadLocalOfflineDocuments instead, like so: [[iCloud sharedCloud] uploadLocalOfflineDocuments]; (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated in version 7.0. Use uploadLocalOfflineDocuments instead.</span>)</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/updateFilesWithDelegate:">+&nbsp;updateFilesWithDelegate:</a></code>
<span class="tooltip"><p>DEPRECATED. Use updateFiles instead, like so: [[iCloud sharedCloud] updateFiles]; (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated in version 7.0. Use updateFiles instead.</span>)</p></span>
</span>


Expand Down Expand Up @@ -1995,7 +2037,7 @@ <h3 class="subsubtitle method-title">saveChangesToDocumentWithName:withContent:c


<div class="method-subsection brief-description">
<p>DEPRECATED. Use saveAndCloseDocumentWithName: instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> This method is deprecated starting in version 7.1. Use methodNameHere: instead. This method may become unavailable in a future version.</span>)</p>
<p>DEPRECATED. Use <a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">saveAndCloseDocumentWithName:withContent:completion:</a> instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated beginning in version 7.1. Use saveAndCloseDocumentWithName:withContent:completion: instead. This method may become unavailable in a future version.</span>)</p>
</div>


Expand Down Expand Up @@ -2401,8 +2443,6 @@ <h4 class="method-subtitle">Declared In</h4>
</div>




</div>
<div class="main-navigation navigation-bottom">
<ul>
Expand Down
Expand Up @@ -133,8 +133,8 @@ <h1 class="title title-header">iCloudDocument Class Reference</h1>
</tr>
</tbody></table></div>


<div class="section section-overview">
<a title="Overview" name="overview"></a>
Expand Down Expand Up @@ -171,6 +171,7 @@ <h3 class="subsubtitle task-title">Methods</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/initWithFileURL:">&ndash;&nbsp;initWithFileURL:</a></code>
<span class="tooltip"><p>Initialize a new UIDocument with the specified file path</p></span>
</span>


Expand All @@ -185,24 +186,28 @@ <h3 class="subsubtitle task-title">Delegate</h3>
<li>
<span class="tooltip">
<code><a href="#//api/name/delegate">&nbsp;&nbsp;delegate</a></code>
<span class="tooltip"><p><a href="../Classes/iCloud.html">iCloud</a> Delegate helps call methods when document processes begin or end</p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/contents">&nbsp;&nbsp;contents</a></code>
<span class="tooltip"><p>The data to read or write to a UIDocument</p></span>
</span>
<span class="task-item-suffix">property</span>

</li><li>
<span class="tooltip">
<code><a href="#//api/name/localizedName">&ndash;&nbsp;localizedName</a></code>
<span class="tooltip"><p>Retrieve the localized name of the current document</p></span>
</span>


</li><li>
<span class="tooltip">
<code><a href="#//api/name/stateDescription">&ndash;&nbsp;stateDescription</a></code>
<span class="tooltip"><p>Retrieve a user-readable form of the document state</p></span>
</span>


Expand Down Expand Up @@ -437,8 +442,6 @@ <h4 class="method-subtitle">Declared In</h4>
</div>




</div>
<div class="main-navigation navigation-bottom">
<ul>
Expand Down

0 comments on commit eb52599

Please sign in to comment.