Apa itu direktori dokumen (NSDocumentDirectory)?

Dapatkah seseorang menjelaskan kepada saya apa direktori dokumen itu di aplikasi iOS dan kapan menggunakannya?

Inilah yang saya yakini saat ini:

Bagi saya, ini tampaknya menjadi folder pusat tempat pengguna dapat menyimpan file apa pun yang diperlukan untuk aplikasi.

Ini akan menjadi lokasi yang berbeda dari tempat Data Inti menyimpan datanya?

Sepertinya setiap aplikasi mendapatkan direktori dokumennya sendiri.

Saya bebas membuat subdirektori dari direktori dokumen, seperti direktori dokumen / gambar, atau direktori dokumen / video?

Hanya aplikasi Anda (pada perangkat yang tidak di-jailbreak) yang berjalan dalam lingkungan "kotak pasir". Artinya, ia hanya dapat mengakses file dan direktori di dalam kontennya sendiri. Misalnya Dokumen dan Perpustakaan .

Lihat Panduan Pemrograman Aplikasi iOS .

Untuk mengakses direktori Dokumen kotak pasir aplikasi Anda, Anda dapat menggunakan yang berikut ini:

iOS 8 dan yang lebih baru, ini adalah metode yang disarankan

+ (NSURL *)applicationDocumentsDirectory
{
     return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
}

jika Anda perlu mendukung iOS 7 atau sebelumnya

+ (NSString *) applicationDocumentsDirectory 
{    
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *basePath = paths.firstObject;
    return basePath;
}

Dokumen iniDirektori memungkinkan Anda menyimpan file dan subdirektori yang dibuat atau mungkin diperlukan oleh aplikasi Anda.

Untuk mengakses file di direktori Library dari kotak pasir aplikasi Anda, gunakan (sebagai pengganti di pathsatas):

[NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0]

Ini telah berubah di iOS 8. Lihat catatan teknis berikut: https://developer.apple.com/library/ios/technotes/tn2406/_index.html

Cara sanksi Apple (dari tautan di atas) adalah sebagai berikut:

// Returns the URL to the application's Documents directory.
- (NSURL *)applicationDocumentsDirectory
{
    return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
}

Saya tidak dapat menemukan kode di dokumen yang disarankan oleh jawaban yang diterima tetapi saya menemukan padanan yang diperbarui di sini:

Panduan Pemrograman Sistem File :: Mengakses File dan Direktori »

- (NSURL*)applicationDataDirectory {
    NSFileManager* sharedFM = [NSFileManager defaultManager];
    NSArray* possibleURLs = [sharedFM URLsForDirectory:NSApplicationSupportDirectory
                                 inDomains:NSUserDomainMask];
    NSURL* appSupportDir = nil;
    NSURL* appDirectory = nil;

    if ([possibleURLs count] >= 1) {
        // Use the first directory (if multiple are returned)
        appSupportDir = [possibleURLs objectAtIndex:0];
    }

    // If a valid app support directory exists, add the
    // app's bundle ID to it to specify the final directory.
    if (appSupportDir) {
        NSString* appBundleID = [[NSBundle mainBundle] bundleIdentifier];
        appDirectory = [appSupportDir URLByAppendingPathComponent:appBundleID];
    }

    return appDirectory;
}

Ini mencegah penggunaan NSSearchPathForDirectoriesInDomain:

Fungsi NSSearchPathForDirectoriesInDomains berperilaku seperti metode URLForDirectory: inDomains: tetapi mengembalikan lokasi direktori sebagai jalur berbasis string. Anda harus menggunakan metode URLForDirectory: inDomains: sebagai gantinya.

Berikut adalah beberapa konstanta direktori berguna lainnya untuk dimainkan. Tidak diragukan lagi tidak semua ini didukung di iOS. Anda juga dapat menggunakan fungsi NSHomeDirectory () yang:

Di iOS, direktori beranda adalah direktori kotak pasir aplikasi. Di OS X, ini adalah direktori kotak pasir aplikasi atau direktori beranda pengguna saat ini (jika aplikasi tidak ada di kotak pasir)

Dari NSPathUtilities.h

NSApplicationDirectory = 1,             // supported applications (Applications)
    NSDemoApplicationDirectory,             // unsupported applications, demonstration versions (Demos)
    NSDeveloperApplicationDirectory,        // developer applications (Developer/Applications). DEPRECATED - there is no one single Developer directory.
    NSAdminApplicationDirectory,            // system and network administration applications (Administration)
    NSLibraryDirectory,                     // various documentation, support, and configuration files, resources (Library)
    NSDeveloperDirectory,                   // developer resources (Developer) DEPRECATED - there is no one single Developer directory.
    NSUserDirectory,                        // user home directories (Users)
    NSDocumentationDirectory,               // documentation (Documentation)
    NSDocumentDirectory,                    // documents (Documents)
    NSCoreServiceDirectory,                 // location of CoreServices directory (System/Library/CoreServices)
    NSAutosavedInformationDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 11,   // location of autosaved documents (Documents/Autosaved)
    NSDesktopDirectory = 12,                // location of user's desktop
    NSCachesDirectory = 13,                 // location of discardable cache files (Library/Caches)
    NSApplicationSupportDirectory = 14,     // location of application support files (plug-ins, etc) (Library/Application Support)
    NSDownloadsDirectory NS_ENUM_AVAILABLE(10_5, 2_0) = 15,              // location of the user's "Downloads" directory
    NSInputMethodsDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 16,           // input methods (Library/Input Methods)
    NSMoviesDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 17,                 // location of user's Movies directory (~/Movies)
    NSMusicDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 18,                  // location of user's Music directory (~/Music)
    NSPicturesDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 19,               // location of user's Pictures directory (~/Pictures)
    NSPrinterDescriptionDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 20,     // location of system's PPDs directory (Library/Printers/PPDs)
    NSSharedPublicDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 21,           // location of user's Public sharing directory (~/Public)
    NSPreferencePanesDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 22,        // location of the PreferencePanes directory for use with System Preferences (Library/PreferencePanes)
    NSApplicationScriptsDirectory NS_ENUM_AVAILABLE(10_8, NA) = 23,      // location of the user scripts folder for the calling application (~/Library/Application Scripts/code-signing-id)
    NSItemReplacementDirectory NS_ENUM_AVAILABLE(10_6, 4_0) = 99,       // For use with NSFileManager's URLForDirectory:inDomain:appropriateForURL:create:error:
    NSAllApplicationsDirectory = 100,       // all directories where applications can occur
    NSAllLibrariesDirectory = 101,          // all directories where resources can occur
    NSTrashDirectory NS_ENUM_AVAILABLE(10_8, NA) = 102                   // location of Trash directory

Dan terakhir, beberapa metode kemudahan dalam kategori NSURL http://club15cc.com/code/ios/easy-ios-file-directory-paths-with-this-handy-nsurl-category

Swift 3 dan 4 sebagai global var:

var documentsDirectory: URL {
    return FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).last!
}

Sebagai ekstensi FileManager:

extension FileManager {
    static var documentsDirectory: URL {
        return `default`.urls(for: .documentDirectory, in: .userDomainMask).last!
    }

    var documentsDirectory: URL {
        return urls(for: .documentDirectory, in: .userDomainMask).last!
    }
}

Selain Documentsfolder, iOS juga memungkinkan Anda menyimpan file ke tempdanLibrary folder .

Untuk informasi lebih lanjut tentang mana yang akan digunakan, lihat tautan ini dari dokumentasi:

• “Di Mana Anda Harus Menempatkan File Aplikasi Anda.”

Akan lebih bersih jika menambahkan ekstensi ke FileManager untuk jenis panggilan canggung ini, untuk kerapihan jika tidak ada yang lain. Sesuatu seperti:

extension FileManager {
    static var documentDir : URL {
        return FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
    }
}

Anda dapat mengakses direktori dokumen menggunakan kode ini yang pada dasarnya digunakan untuk menyimpan file dalam format plist:

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths firstObject];
return documentsDirectory;

Berikut adalah fungsi kecil yang berguna, yang membuat penggunaan / pembuatan folder iOS sedikit lebih mudah.

Anda memberikannya nama subfolder, itu akan mengembalikan path lengkap kembali kepada Anda, dan memastikan direktori tersebut ada.

(Secara pribadi, saya tetap menggunakan fungsi statis ini di kelas AppDelete saya, tetapi mungkin ini bukan tempat paling cerdas untuk meletakkannya.)

Begini cara Anda menyebutnya, untuk mendapatkan "jalur lengkap" dari subdirektori MySavedImages:

NSString* fullPath = [AppDelegate getFullPath:@"MySavedImages"];

Dan inilah fungsi lengkapnya:

+(NSString*)getFullPath:(NSString*)folderName
{
    //  Check whether a subdirectory exists in our sandboxed Documents directory.
    //  Returns the full path of the directory.
    //
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    if (paths.count < 1)
        return nil;

    NSString *rootFolder = [paths firstObject];
    NSString* fullFolderPath = [rootFolder stringByAppendingPathComponent:folderName];

    BOOL isDirectory;
    NSFileManager* manager = [NSFileManager defaultManager];

    if (![manager fileExistsAtPath:fullFolderPath isDirectory:&isDirectory] || !isDirectory) {
        NSError *error = nil;
        NSDictionary *attr = [NSDictionary dictionaryWithObject:NSFileProtectionComplete
                                                         forKey:NSFileProtectionKey];
        [manager createDirectoryAtPath:fullFolderPath
           withIntermediateDirectories:YES
                            attributes:attr
                                 error:&error];
        if (error) {
            NSLog(@"Error creating directory path: %@", [error localizedDescription]);
            return nil;
        }
    }
    return fullFolderPath;
}

Dengan menggunakan fungsi kecil ini, mudah untuk membuat direktori di direktori Dokumen aplikasi Anda (jika belum ada), dan menulis file ke dalamnya.

Inilah cara saya membuat direktori, dan menulis konten dari salah satu file gambar saya ke dalamnya:

//  Let's create a "MySavedImages" subdirectory (if it doesn't already exist)
NSString* fullPath = [AppDelegate getFullPath:@"MySavedImages"];

//  As an example, let's load the data in one of my images files
NSString* imageFilename = @"icnCross.png";

UIImage* image = [UIImage imageNamed:imageFilename];
NSData *imageData = UIImagePNGRepresentation(image);

//  Obtain the full path+filename where we can write this .png to, in our new MySavedImages directory
NSString* imageFilePathname = [fullPath stringByAppendingPathComponent:imageFilename];

//  Write the data
[imageData writeToFile:imageFilePathname atomically:YES];

Semoga ini membantu !

Seperti orang lain yang disebutkan, aplikasi Anda berjalan dalam lingkungan kotak pasir dan Anda dapat menggunakan direktori dokumen untuk menyimpan gambar atau aset lain yang mungkin digunakan aplikasi Anda, mis. mengunduh file offline-d sesuai keinginan pengguna - Dasar Sistem File - Dokumentasi Apple - Direktori mana yang digunakan, untuk menyimpan file khusus aplikasi

Diperbarui ke swift 5, Anda dapat menggunakan salah satu dari fungsi ini, sesuai kebutuhan -

func getDocumentsDirectory() -> URL {
    let paths = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
    return paths[0]
}

func getCacheDirectory() -> URL {
        let paths = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask)
        return paths[0]
    }

func getApplicationSupportDirectory() -> URL {
        let paths = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask)
        return paths[0]
    }

Pemakaian:

let urlPath = "https://jumpcloud.com/wp-content/uploads/2017/06/SSH-Keys.png" //Or string path to some URL of valid image, for eg.

if let url = URL(string: urlPath){
    let destination = getDocumentsDirectory().appendingPathComponent(url.lastPathComponent)
    do {
        let data = try Data(contentsOf: url) //Synchronous call, just as an example
        try data.write(to: destination)
    } catch _ {
        //Do something to handle the error
    }
}