You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/08/01 22:23:42 UTC
[1/3] CB-7249cordova-plugin-file documentation translation:
cordova-plugin-file
Repository: cordova-plugin-file
Updated Branches:
refs/heads/master 891325739 -> fa64fa54c
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
index fec09ae..c031b8a 100644
--- a/doc/pl/index.md
+++ b/doc/pl/index.md
@@ -19,11 +19,21 @@
# org.apache.cordova.file
-Plugin daje [HTML5 API systemu plików][1]. Za zwyczaj odnoszą się do skały HTML5 [plików artykuł][2] na ten temat. Omówienie innych opcji przechowywania odnoszą się do Cordova z [magazynu przewodnik][3].
+Ten plugin implementuje API pliku, dzięki czemu dostęp do odczytu i zapisu do plików znajdujących się na urządzeniu.
- [1]: http://dev.w3.org/2009/dap/file-system/pub/FileSystem/
- [2]: http://www.html5rocks.com/en/tutorials/file/filesystem/
- [3]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html
+Ten plugin jest oparty na kilka specyfikacje, w tym: HTML5 File API <http://www.w3.org/TR/FileAPI/>
+
+Katalogi (nieistniejącego już) i System Najnowsze rozszerzenia: <http://www.w3.org/TR/2012/WD-file-system-api-20120417/> , chociaż większość z ten plugin kod został napisany podczas wcześniejszych specyfikacji były aktualne: <http://www.w3.org/TR/2011/WD-file-system-api-20110419/>
+
+To również implementuje specyfikację FileWriter: <http://dev.w3.org/2009/dap/file-system/file-writer.html>
+
+Wykorzystania, prosimy odnieść się do skały HTML5 doskonałe [plików art.][1]
+
+ [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/
+
+Omówienie innych opcji przechowywania odnoszą się do Cordova z [magazynu przewodnik][2].
+
+ [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html
## Instalacji
@@ -35,10 +45,10 @@ Plugin daje [HTML5 API systemu plików][1]. Za zwyczaj odnoszą się do skały H
* Amazon ogień OS
* Android
* Jeżyna 10
+* Firefox OS
* iOS
* Windows Phone 7 i 8 *
* Windows 8 *
-* Firefox OS
* *Nie obsługują te platformy `FileReader.readAsArrayBuffer` , ani `FileWriter.write(blob)` .*
@@ -46,55 +56,116 @@ Plugin daje [HTML5 API systemu plików][1]. Za zwyczaj odnoszą się do skały H
Od v1.2.0 znajdują się adresy URL do katalogów ważne systemu plików. Każdy adres URL jest w formie *file:///path/to/spot/*i mogą być konwertowane na `DirectoryEntry` za pomocą`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Tylko do odczytu katalogu gdzie jest zainstalowana aplikacja. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Tylko do odczytu katalogu gdzie jest zainstalowana aplikacja. (*iOS*, *Android*, *BlackBerry 10*)
+
+* `cordova.file.applicationStorageDirectory`-Katalogu obszaru izolowanego aplikacji; na iOS to miejsce jest tylko do odczytu (ale podkatalogów określonego [jak `/Documents` ] są odczytu i zapisu). Wszystkie dane zawarte w jest prywatną do aplikacji. ( *iOS*, *Android*, *BlackBerry 10*)
+
+* `cordova.file.dataDirectory`-Trwałe i prywatne dane magazynowanie w izolowanym aplikacji przy użyciu pamięci wewnętrznej (na Android, jeśli trzeba użyć zewnętrznej pamięci, należy użyć `.externalDataDirectory` ). Na iOS, Katalog ten nie jest zsynchronizowane z iCloud (za pomocą `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
+
+* `cordova.file.cacheDirectory`-Katalog dla plików buforowanych danych lub pliki, które aplikacji ponownie można łatwo tworzyć. System operacyjny może usunąć te pliki, gdy urządzenie działa niski na przechowywanie, niemniej jednak aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj. (*iOS*, *Android*, *BlackBerry 10*)
+
+* `cordova.file.externalApplicationStorageDirectory`-Stosowania przestrzeni na zewnętrznej pamięci masowej. (*Android*)
+
+* `cordova.file.externalDataDirectory`-Gdzie umieścić pliki danych specyficznych dla aplikacji na zewnętrznej pamięci masowej. (*Android*)
-`cordova.file.applicationStorageDirectory`-Pierwiastek z prywatnego składowania zapisu aplikacji. (*iOS*, *Android*)
+* `cordova.file.externalCacheDirectory`-Pamięci podręcznej aplikacji na zewnętrznej pamięci masowej. (*Android*)
-`cordova.file.dataDirectory`-Gdzie umieścić pliki dane specyficzne dla aplikacji. (*iOS*, *Android*)
+* `cordova.file.externalRootDirectory`-Korzeń zewnętrznej pamięci masowej (karty SD). (*Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-W pamięci podręcznej plików, które powinny przetrwać aplikacja zostanie ponownie uruchomiony. Aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj. (*iOS*, *Android*)
+* `cordova.file.tempDirectory`-Temp katalogu systemu operacyjnego można wyczyścić w będzie. Nie należy polegać na OS wobec usunąć ten katalog; aplikacji należy zawsze usunąć pliki jako obowiązujące. (*iOS*)
-`cordova.file.externalApplicationStorageDirectory`-Stosowania przestrzeni na zewnętrznej pamięci masowej. (*iOS*, *Android*)
+* `cordova.file.syncedDataDirectory`-Posiada pliki specyficzne dla aplikacji, które powinny być zsynchronizowane (np. do iCloud). (*iOS*)
-`cordova.file.externalDataDirectory`-Gdzie umieścić pliki danych specyficznych dla aplikacji na zewnętrznej pamięci masowej. (*Android*)
+* `cordova.file.documentsDirectory`-Pliki prywatne do aplikacji, ale że mają znaczenie dla innych aplikacji (np. plików pakietu Office). (*iOS*)
-`cordova.file.externalCacheDirectory`-Pamięci podręcznej aplikacji na zewnętrznej pamięci masowej. (*Android*)
+* `cordova.file.sharedDirectory`-Pliki dostępne na całym świecie do wszystkich aplikacji (*BlackBerry 10*)
-`cordova.file.externalRootDirectory`-Korzeń zewnętrznej pamięci masowej (karty SD). (*Android*)
+## Plik System układy
-`cordova.file.tempDirectory`-Temp katalogu systemu operacyjnego można wyczyścić w będzie. (*iOS*)
+Chociaż technicznie implementacyjnym, może być bardzo przydatne wiedzieć, jak `cordova.file.*` Właściwości mapy fizycznej ścieżki na prawdziwe urządzenie.
-`cordova.file.syncedDataDirectory`-Posiada pliki specyficzne dla aplikacji, które powinny być zsynchronizowane (np. do iCloud). (*iOS*)
+### iOS układ systemu plików
-`cordova.file.documentsDirectory`-Pliki prywatne do aplikacji, ale że są znaczące dla innych applciations (np. plików pakietu Office). (*iOS*)
+| Ścieżka urządzenia | `Cordova.File.*` | `iosExtraFileSystems` | r/w? | trwałe? | Czyści OS | Synchronizacja | prywatne |
+|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:-------:|:-----------:|:--------------:|:--------:|
+| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r/o | N/D! | N/D! | N/D! | Tak |
+| `appname.app/` | applicationDirectory | pakiet | r/o | N/D! | N/D! | N/D! | Tak |
+| `www/` | - | - | r/o | N/D! | N/D! | N/D! | Tak |
+| `Documents/` | documentsDirectory | dokumenty | r/w | Tak | Nr | Tak | Tak |
+| `NoCloud/` | - | dokumenty nosync | r/w | Tak | Nr | Nr | Tak |
+| `Library` | - | Biblioteka | r/w | Tak | Nr | Tak? | Tak |
+| `NoCloud/` | dataDirectory | Biblioteka nosync | r/w | Tak | Nr | Nr | Tak |
+| `Cloud/` | syncedDataDirectory | - | r/w | Tak | Nr | Tak | Tak |
+| `Caches/` | cacheDirectory | pamięci podręcznej | r/w | Tak * | Tak \* * *| | Nr | Tak |
+| `tmp/` | tempDirectory | - | r/w | Nie * * | Tak \* * *| | Nr | Tak |
+
+* Pliki utrzymywały aplikacja zostanie ponownie uruchomiony i uaktualnienia, ale w tym katalogu mogą być rozliczone, gdy OS pragnienia. Aplikacji powinny być w stanie odtworzyć zawartość, która może być usunięta.
+
+* * Plików może utrzymywać się po ponownym uruchomieniu aplikacji, ale nie opierają się na tym zachowaniu. Pliki nie są gwarantowane w aktualizacji. Aplikacji należy usunąć pliki z tego katalogu, gdy ma to zastosowanie, ponieważ system operacyjny nie gwarantuje Kiedy (lub nawet jeśli) te pliki zostaną usunięte.
+
+\* * *| System operacyjny może wyczyścić zawartość w tym katalogu, gdy czuje, że jest to konieczne, ale nie powoływać się na to. Należy wyczyścić ten katalog jako odpowiednie dla aplikacji.
+
+### Układ systemu Android plików
+
+| Ścieżka urządzenia | `Cordova.File.*` | `AndroidExtraFileSystems` | r/w? | trwałe? | Czyści OS | prywatne |
+|:--------------------------------------- |:----------------------------------- |:------------------------------- |:----:|:-------:|:---------:|:--------:|
+| `file:///android_asset/` | applicationDirectory | | r/o | N/D! | N/D! | Tak |
+| `/Data/danych/< Aplikacja id > /` | applicationStorageDirectory | - | r/w | N/D! | N/D! | Tak |
+| `cache` | cacheDirectory | pamięci podręcznej | r/w | Tak | Tak * | Tak |
+| `files` | dataDirectory | pliki | r/w | Tak | Nr | Tak |
+| `Documents` | | dokumenty | r/w | Tak | Nr | Tak |
+| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Tak | Nr | Nr |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Tak | Nr | Nr |
+| `cache` | externalCacheDirectry | zewnętrznych pamięci podręcznej | r/w | Tak | Nie * * | Nr |
+| `files` | externalDataDirectory | zewnętrznych plików | r/w | Tak | Nr | Nr |
+
+* System operacyjny może okresowo usunąć ten katalog, ale nie opierają się na tym zachowaniu. Wyczyść zawartość tego katalogu jako odpowiednie dla danej aplikacji. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość w tym katalogu są usuwane.
+
+* * System operacyjny nie usunąć ten katalog automatycznie; Jesteś odpowiedzialny za zarządzanie zawartość siebie. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość katalogu są usuwane.
+
+**Uwaga**: Jeśli nie mogą być montowane pamięci masowej, `cordova.file.external*` Właściwości są`null`.
+
+### Układ systemu plików blackBerry 10
+
+| Ścieżka urządzenia | `Cordova.File.*` | r/w? | trwałe? | Czyści OS | prywatne |
+|:--------------------------------------------------------- |:--------------------------- |:----:|:-------:|:---------:|:--------:|
+| `file:///accounts/1000/AppData/ < id aplikacji > /` | applicationStorageDirectory | r/o | N/D! | N/D! | Tak |
+| `app/native` | applicationDirectory | r/o | N/D! | N/D! | Tak |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Nr | Tak | Tak |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Tak | Nr | Tak |
+| `file:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Tak | Nr | Nr |
+| `file:///accounts/1000/Shared` | sharedDirectory | r/w | Tak | Nr | Nr |
+
+*Uwaga*: gdy aplikacja jest rozmieszczana do pracy obwodu, wszystkie ścieżki są względne do /accounts/1000-enterprise.
## Android dziwactwa
### Lokalizacja przechowywania trwałych Android
-Istnieje wiele prawidłowe lokalizacje do przechowywania trwałych plików na telefonie z systemem Android. Zobacz [tę stronę][4] do szerokiej dyskusji o różnych możliwościach.
+Istnieje wiele prawidłowe lokalizacje do przechowywania trwałych plików na telefonie z systemem Android. Zobacz [tę stronę][3] do szerokiej dyskusji o różnych możliwościach.
- [4]: http://developer.android.com/guide/topics/data/data-storage.html
+ [3]: http://developer.android.com/guide/topics/data/data-storage.html
Poprzednie wersje pluginu wybrać lokalizację plików tymczasowych i trwałe podczas uruchamiania, czy urządzenie twierdził, że karta SD (lub równoważne magazynowanie podzia³) był montowany w oparciu. Czy karta SD została zamontowana, czy duży wewnętrzny magazynowanie podzia³ był dostępny (takie jak na Nexus urządzenia,) a następnie trwałe pliki będą przechowywane w katalogu głównego tego miejsca. Oznaczało to, że wszystkie aplikacje Cordova może Zobacz wszystkie pliki dostępne na karcie.
-Jeśli karta SD nie był dostępny, poprzednie wersje będzie przechowywać dane w /data/danych /<packageid>, która izoluje aplikacje od siebie, ale nadal może spowodować danych, które mają być współużytkowane przez użytkowników.
+Jeśli karta SD nie był dostępny, a następnie poprzednie wersje będzie przechowywać dane w `/data/data/<packageId>` , która izoluje aplikacje od siebie, ale nadal może spowodować danych, które mają być współużytkowane przez użytkowników.
-Teraz jest możliwe, aby zdecydować, czy do przechowywania plików w lokalizacji magazynu plików, lub przy użyciu poprzednich logiki, z preferencją w aplikacji w pliku config.xml. Aby to zrobić, Dodaj jedną z tych dwóch linii do pliku config.xml:
+Teraz jest możliwe, aby zdecydować, czy do przechowywania plików w lokalizacji magazynu plików, lub przy użyciu poprzedniej logiki, z preferencją w aplikacji `config.xml` pliku. Aby to zrobić, należy dodać jeden z tych dwóch linii do `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Bez tej linii wtyczki pliku będzie używać "Zgodność" jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.
+Bez tej linii, użyje pliku plugin `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.
-Jeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje "Zgodności". Przełączania lokalizacji do "Wewnętrznego" oznacza, że istniejących użytkowników, którzy ich aplikacja może być niesłabnący wobec dostęp ich wcześniej zapisane pliki, w zależności od ich urządzenie.
+Jeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu oraz pliki przechowywane w trwałych plików, a następnie należy ustawić preferencje `Compatibility` . Przełączania lokalizacji do "Wewnętrznego" oznacza, że istniejących użytkowników, którzy ich aplikacja może być niesłabnący wobec dostęp ich wcześniej zapisane pliki, w zależności od ich urządzenie.
-Jeśli aplikacja jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików trwałe, ustawienie "wewnętrznego" Generalnie jest zalecane.
+Jeśli aplikacja jest nowy, lub nigdy wcześniej przechowywane pliki w trwałych plików, a następnie `Internal` ustawienie jest zwykle zalecane.
## iOS dziwactwa
+* `cordova.file.applicationStorageDirectory`jest tylko do odczytu; próby przechowywania plików w katalogu głównym zakończy się niepowodzeniem. Użyj jednego z innych `cordova.file.*` właściwości zdefiniowane dla iOS (tylko `applicationDirectory` i `applicationStorageDirectory` są tylko do odczytu).
* `FileReader.readAsText(blob, encoding)`
* `encoding`Parametr nie jest obsługiwana, i kodowanie UTF-8 jest zawsze w efekcie.
@@ -102,28 +173,29 @@ Jeśli aplikacja jest nowy, lub ma nigdy wcześniej przechowywane pliki w system
Istnieją dwa ważne miejsca trwałe pliki na urządzenia iOS: katalogu dokumentów i katalogu biblioteki. Poprzednie wersje pluginu tylko kiedykolwiek przechowywane trwałe pliki w katalogu dokumentów. To miał ten efekt uboczny od rozpoznawalności wszystkie pliki aplikacji w iTunes, który był często niezamierzone, zwłaszcza dla aplikacji, które obsługują wiele małych plików, zamiast produkuje kompletne dokumenty do wywozu, który jest przeznaczenie katalogu.
-Teraz jest możliwe, aby zdecydować, czy do przechowywania plików w dokumentach lub katalogu biblioteki, z preferencją w pliku config.xml aplikacji. Aby to zrobić, Dodaj jedną z tych dwóch linii do pliku config.xml:
+Teraz jest możliwe, aby zdecydować, czy do przechowywania danych w dokumentach lub katalogu biblioteki, z preferencją w aplikacji `config.xml` pliku. Aby to zrobić, należy dodać jeden z tych dwóch linii do `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Bez tej linii wtyczki pliku będzie używać "Zgodność" jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.
+Bez tej linii, użyje pliku plugin `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.
-Jeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje "Zgodności". Przełączania lokalizacji "Biblioteki" oznacza, że istniejących użytkowników, którzy ich aplikacja będzie niesłabnący wobec dostęp ich wcześniej zapisane pliki.
+Jeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu oraz pliki przechowywane w trwałych plików, a następnie należy ustawić preferencje `Compatibility` . Przełączania lokalizacji `Library` oznaczałoby, że istniejących użytkowników, którzy ich aplikacja będzie niesłabnący wobec dostęp ich wcześniej zapisane pliki.
-Jeśli aplikacja jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików trwałe, ustawienie "Biblioteki" Generalnie jest zalecane.
+Jeśli aplikacja jest nowy, lub nigdy wcześniej przechowywane pliki w trwałych plików, a następnie `Library` ustawienie jest zwykle zalecane.
-### Firefox OS dziwactwa
+## Firefox OS dziwactwa
API systemu plików nie jest obsługiwany macierzyście przez Firefox OS i jest zaimplementowany jako podkładki na indexedDB.
* Nie usuwając niepuste katalogi
* Nie obsługuje metadane dla katalogów
-* Nie obsługuje `requestAllFileSystems` i `resolveLocalFileSystemURI` metody
* Metody `copyTo` i `moveTo` nie obsługuje katalogi
+Obsługiwane są następujące ścieżki danych: * `applicationDirectory` -używa `xhr` Aby uzyskać lokalne pliki, które są pakowane z aplikacji. * `dataDirectory` - Na trwałe dane specyficzne dla aplikacji pliki. * `cacheDirectory` -Buforowane pliki, które powinny przetrwać ponowne uruchomienie aplikacji (aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj).
+
## Uaktualniania notatek
W v1.0.0 ten plugin `FileEntry` i `DirectoryEntry` struktur zmieniły się, aby być bardziej zgodnie z opublikowaną specyfikacją.
@@ -143,7 +215,7 @@ Z v1.0.0 `fullPath` atrybut jest ścieżką do pliku, *względem katalogu głów
Jeśli aplikacja działa z ścieżki bezwzględnej urządzeń, i możesz wcześniej źródło tych ścieżek za pomocą `fullPath` Właściwość `Entry` obiektów, a następnie należy zaktualizować kod, aby użyć `entry.toURL()` zamiast.
-Do tyłu zgodności, `resolveLocalFileSystemURL()` Metoda akceptuje pomysł ścieżka bezwzględna i zwróci `Entry` obiektu odpowiadającego mu, tak długo, jak ten plik istnieje w tymczasowe lub trwałe systemy plików.
+Do tyłu zgodności, `resolveLocalFileSystemURL()` Metoda akceptuje pomysł ścieżka bezwzględna i zwróci `Entry` obiektu odpowiadającego mu, tak długo, jak ten plik istnieje w albo `TEMPORARY` lub `PERSISTENT` plików.
To szczególnie został problem z pluginem transferu plików, które poprzednio używane ścieżki bezwzględnej urządzeń (i wciąż można je przyjąć). To został zaktualizowany, aby działać poprawnie z adresów URL plików, więc wymiana `entry.fullPath` z `entry.toURL()` powinno rozwiązać wszelkie problemy dostawanie ten plugin do pracy z plików w pamięci urządzenia.
@@ -158,18 +230,20 @@ który służy do jednoznacznej identyfikacji pliku.
Gdy błąd jest generowany, jeden z następujących kodów będzie służyć.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Kod | Stała |
+| ---:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Konfigurowanie wtyczka (opcjonalny)
@@ -181,21 +255,21 @@ Zestaw dostępnych plików może być skonfigurowany na platformie. Zarówno iOS
### Android
-* pliki: katalogu przechowywania plików aplikacji
-* zewnętrzne pliki: katalog aplikacji zewnętrznych plików
-* sdcard: katalog globalny plik zewnętrzny (to jest głównym karty SD, jeśli jedna jest zainstalowana). Musisz mieć `android.permission.WRITE_EXTERNAL_STORAGE` uprawnienie do korzystania z tego.
-* pamięć podręczna: katalogu wewnętrznej pamięci podręcznej aplikacji
-* pamięci podręcznej zewnętrzne: katalogu aplikacji zewnętrznych pamięci podręcznej
-* korzeń: całe urządzenie systemu plików
+* `files`: Katalog plików aplikacja
+* `files-external`: Katalog aplikacji zewnętrznych plików
+* `sdcard`: Globalny plik zewnętrzny magazyn katalogu (to jest głównym karty SD, jeśli jedna jest zainstalowana). Musisz mieć `android.permission.WRITE_EXTERNAL_STORAGE` uprawnienie do korzystania z tego.
+* `cache`: Katalogu stosowanie wewnętrznej pamięci podręcznej
+* `cache-external`: Katalog aplikacji zewnętrznych pamięci podręcznej
+* `root`: Całe urządzenie systemu plików
Android obsługuje również specjalnych plików o nazwie "dokumenty", który reprezentuje podkatalog "/ dokumenty /" w ramach systemu plików "pliki".
### iOS
-* Biblioteka: katalog biblioteki aplikacji
-* dokumenty: dokumenty katalogu aplikacji
-* pamięć podręczna: katalogu pamięci podręcznej aplikacji
-* pakiet: pakiet aplikacji; Lokalizacja aplikacji na dysku (tylko do odczytu)
-* korzeń: całe urządzenie systemu plików
+* `library`: Katalog biblioteki aplikacji
+* `documents`: Katalog dokumentów wniosek
+* `cache`: W katalogu pamięci podręcznej aplikacja
+* `bundle`: Pakiet aplikacji; Lokalizacja aplikacji na dysku (tylko do odczytu)
+* `root`: Całe urządzenie systemu plików
-Domyślnie katalogi biblioteki i dokumenty mogą być synchronizowane iCloud. Można również zażądać dwóch dodatkowych plików, "biblioteka nosync" i "dokumenty nosync", które stanowią specjalny katalog nie zsynchronizowane w bibliotece lub dokumentów systemu plików.
\ No newline at end of file
+Domyślnie katalogi biblioteki i dokumenty mogą być synchronizowane iCloud. Można również zażądać dwóch dodatkowych plików, `library-nosync` i `documents-nosync` , które stanowią specjalny katalog nie zsynchronizowane w `/Library` lub `/Documents` systemu plików.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/ru/index.md
----------------------------------------------------------------------
diff --git a/doc/ru/index.md b/doc/ru/index.md
index b50979d..a6035a7 100644
--- a/doc/ru/index.md
+++ b/doc/ru/index.md
@@ -56,27 +56,87 @@
По состоянию на v1.2.0 приведены URL-адреса для важных файлов в системные каталоги. Каждый URL-адрес в виде *file:///path/to/spot/*и может быть преобразован в `DirectoryEntry` с помощью`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Каталог только для чтения, где установлено приложение. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Каталог только для чтения, где установлено приложение. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.applicationStorageDirectory`-Корень приложения частные записи хранения. (*iOS*, *Android*)
+* `cordova.file.applicationStorageDirectory`-Корневой каталог приложения в песочнице; на iOS это место только для чтения (но определенных подкаталогов [как `/Documents` ], чтения записи). Все данные, содержащиеся в частных в приложение. ( *iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.dataDirectory`-Куда положить файлы данных конкретного приложения. (*iOS*, *Android*)
+* `cordova.file.dataDirectory`-Хранения стойкие и частных данных в приложения в песочнице с использованием внутренней памяти (на Android, если необходимо использовать внешнюю память, использовать `.externalDataDirectory` ). На iOS, этот каталог не синхронизируется с iCloud (использование `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-Кэшированных файлов, которые должны выжить перезапускает приложение. Приложения не должны полагаться на OS, чтобы удалить файлы здесь. (*iOS*, *Android*)
+* `cordova.file.cacheDirectory`-Каталог для кэшированных данных файлов или все файлы, которые ваше приложение может повторно создать легко. ОС может удалить эти файлы, когда устройства хватает на хранение, тем не менее, приложения не должны опираться на OS, чтобы удалить файлы здесь. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.externalApplicationStorageDirectory`-Пространство приложения на внешнем хранилище. (*iOS*, *Android*)
+* `cordova.file.externalApplicationStorageDirectory`-Пространство приложения на внешнем хранилище. (*Android*)
-`cordova.file.externalDataDirectory`-Куда положить файлы данных конкретного приложения на внешнем хранилище. (*Android*)
+* `cordova.file.externalDataDirectory`-Куда положить файлы данных конкретного приложения на внешнем хранилище. (*Android*)
-`cordova.file.externalCacheDirectory`-Применение кэш на внешние накопители. (*Android*)
+* `cordova.file.externalCacheDirectory`-Применение кэш на внешние накопители. (*Android*)
-`cordova.file.externalRootDirectory`-Корень внешние накопители (SD карта). (*Android*)
+* `cordova.file.externalRootDirectory`-Корень внешние накопители (SD карта). (*Android*, *BlackBerry 10*)
-`cordova.file.tempDirectory`-Временный каталог, что ОС можно снять на будет. (*iOS*)
+* `cordova.file.tempDirectory`-Временный каталог, что ОС можно снять на будет. Не следует полагаться на OS, чтобы очистить этот каталог; Ваше приложение всегда следует удалять файлы в соответствующих случаях. (*iOS*)
-`cordova.file.syncedDataDirectory`-Содержит файлы приложения, которые должны быть синхронизированы (например, к iCloud). (*iOS*)
+* `cordova.file.syncedDataDirectory`-Содержит файлы приложения, которые должны быть синхронизированы (например, к iCloud). (*iOS*)
-`cordova.file.documentsDirectory`-Файлы для приложения, но это являются значимыми для других приложениям (например, файлы Office). (*iOS*)
+* `cordova.file.documentsDirectory`-Файлы для приложения, но это являются значимыми для других приложений (например, файлы Office). (*iOS*)
+
+* `cordova.file.sharedDirectory`-Файлы глобально доступной для всех приложений (*BlackBerry 10*)
+
+## Макеты файловой системы
+
+Хотя технически деталь реализации, она может быть очень полезно знать как `cordova.file.*` карта свойства физические пути на реальном устройстве.
+
+### iOS расположения файловой системы
+
+| Путь к устройству | `Cordova.File.*` | `iosExtraFileSystems` | r/w? | стойкие? | Очищает ОС | Синхронизация | частные |
+|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:--------:|:----------:|:-------------:|:-------:|
+| `/ var/мобильного/применения/< UUID > /` | applicationStorageDirectory | - | r/o | Н/Д | Н/Д | Н/Д | Да |
+| `appname.app/` | applicationDirectory | расслоение | r/o | Н/Д | Н/Д | Н/Д | Да |
+| `www/` | - | - | r/o | Н/Д | Н/Д | Н/Д | Да |
+| `Documents/` | documentsDirectory | документы | r/w | Да | Нет | Да | Да |
+| `NoCloud/` | - | документы nosync | r/w | Да | Нет | Нет | Да |
+| `Library` | - | Библиотека | r/w | Да | Нет | Да? | Да |
+| `NoCloud/` | dataDirectory | Библиотека nosync | r/w | Да | Нет | Нет | Да |
+| `Cloud/` | syncedDataDirectory | - | r/w | Да | Нет | Да | Да |
+| `Caches/` | cacheDirectory | кэш | r/w | Да * | Да \* * *| | Нет | Да |
+| `tmp/` | tempDirectory | - | r/w | Не * * | Да \* * *| | Нет | Да |
+
+* Файлы сохраняются приложения перезагрузки и обновления, но этот каталог может быть очищен, когда ОС желаний. Ваше приложение должно иметь возможность воссоздать любое содержание, которое может быть удалено.
+
+* * Файлы могут сохраняться перезагрузками app, но не полагайтесь на это поведение. Для продолжения обновления файлов не гарантируется. Приложение должно удалить файлы из этого каталога, когда это применимо, как операционная система не гарантирует когда (или даже если) эти файлы будут удалены.
+
+\* * *| ОС может очистить содержимое этого каталога, когда он считает это необходимым, но не полагайтесь на это. Необходимо снять этот каталог в зависимости от вашего приложения.
+
+### Расположения Android файловой системы
+
+| Путь к устройству | `Cordova.File.*` | `AndroidExtraFileSystems` | r/w? | стойкие? | Очищает ОС | частные |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:--------:|:----------:|:-------:|
+| `File:///android_asset/` | applicationDirectory | | r/o | Н/Д | Н/Д | Да |
+| `/ Data/data/< app-id > /` | applicationStorageDirectory | - | r/w | Н/Д | Н/Д | Да |
+| `cache` | cacheDirectory | кэш | r/w | Да | Да * | Да |
+| `files` | dataDirectory | файлы | r/w | Да | Нет | Да |
+| `Documents` | | документы | r/w | Да | Нет | Да |
+| `< sdcard > /` | externalRootDirectory | SDCard | r/w | Да | Нет | Нет |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Да | Нет | Нет |
+| `cache` | externalCacheDirectry | кэш внешние | r/w | Да | Не * * | Нет |
+| `files` | externalDataDirectory | файлы внешние | r/w | Да | Нет | Нет |
+
+* ОС может периодически удалять этот каталог, но не полагайтесь на это поведение. Очистите содержимое этого каталога в зависимости от вашего приложения. Если пользователь вручную очистить кэш, содержимое этого каталога будут удалены.
+
+* * ОС не ясно этот каталог автоматически; Вы несете ответственность за управление содержимым самостоятельно. Если пользователь вручную очистить кэш, содержимое каталога будут удалены.
+
+**Примечание**: Если нельзя монтировать внешние накопители, `cordova.file.external*` Свойства`null`.
+
+### BlackBerry 10 расположения файловой системы
+
+| Путь к устройству | `Cordova.File.*` | r/w? | стойкие? | Очищает ОС | частные |
+|:--------------------------------------------------- |:--------------------------- |:----:|:--------:|:----------:|:-------:|
+| `File:///Accounts/1000/AppData/ < app id > /` | applicationStorageDirectory | r/o | Н/Д | Н/Д | Да |
+| `app/native` | applicationDirectory | r/o | Н/Д | Н/Д | Да |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Нет | Да | Да |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Да | Нет | Да |
+| `File:///Accounts/1000/Removable/SDCard` | externalRemovableDirectory | r/w | Да | Нет | Нет |
+| `File:///Accounts/1000/Shared` | sharedDirectory | r/w | Да | Нет | Нет |
+
+*Примечание*: при развертывании приложения для работы периметра, все пути относительны /accounts/1000-enterprise.
## Android причуды
@@ -88,23 +148,24 @@
Предыдущие версии плагина будет выбирать расположение временных и постоянных файлов при запуске, основанный на ли устройство утверждал, что SD-карта (или эквивалентные хранения раздел) был смонтирован. Если была смонтирована SD-карты, или если большой внутренней памяти раздел был доступен (такие как на устройствах Nexus,), то постоянные файлы будут храниться в корне этого пространства. Это означало, что все apps Cordova могли видеть все файлы, имеющиеся на карте.
-Если SD-карты не был доступен, затем предыдущих версий будет хранить данные в/Data/data /<packageid>, который изолирует приложения друг от друга, но все еще может вызвать данные распределяются между пользователями.
+Если SD-карты не был доступен, то предыдущих версий будет хранить данные в `/data/data/<packageId>` , которая изолирует приложения друг от друга, но все еще может причина данные распределяются между пользователями.
-Теперь можно выбрать, следует ли хранить файлы в месте хранения внутренних файлов, или с использованием предыдущей логики, с предпочтением в файле config.xml вашего приложения. Чтобы сделать это, добавьте один из этих двух линий в файл config.xml:
+Это теперь можно выбрать, следует ли хранить файлы в месте хранения внутренних файлов, или с использованием предыдущей логики, с предпочтением в вашем приложении `config.xml` файл. Чтобы сделать это, добавить один из этих двух линий в `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Без этой линии плагин файл будет использовать «Совместимость» по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.
+Без этой линии, будет использовать файл плагина `Compatibility` по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.
-Если ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения для «Совместимость». Переключение местоположение для «Внутреннего» будет означать, что существующие пользователи, которые обновить их применение может быть не в состоянии получить доступ к их сохраненные ранее файлы, в зависимости от их устройства.
+Если ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения `Compatibility` . Переключение местоположение для «Внутреннего» будет означать, что существующие пользователи, которые обновить их применение может быть не в состоянии получить доступ к их сохраненные ранее файлы, в зависимости от их устройства.
-Если ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, параметр «внутренней» обычно рекомендуется.
+Если ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, то `Internal` как правило рекомендуется настройка.
## iOS причуды
+* `cordova.file.applicationStorageDirectory`доступен только для чтения; попытка хранения файлов в корневом каталоге не удастся. Использовать один из других `cordova.file.*` свойства, определенные для iOS (только `applicationDirectory` и `applicationStorageDirectory` доступны только для чтения).
* `FileReader.readAsText(blob, encoding)`
* `encoding`Параметр не поддерживается, и UTF-8 кодирование действует всегда.
@@ -112,28 +173,29 @@
Существует два допустимых местоположений для хранения постоянных файлов на устройства iOS: документы каталогов и библиотека. Предыдущие версии плагина только когда-либо постоянные файлы хранятся в папке документы. Это был побочный эффект делает все файлы приложения в iTunes, который часто был непреднамеренным, особенно для приложений, которые обрабатывают большое количество мелких файлов, вместо того, чтобы производить полный комплект документов для экспорта, который является цель каталога.
-Теперь можно выбрать, следует ли хранить файлы в документы или каталог библиотеки, с предпочтением в файле config.xml вашего приложения. Чтобы сделать это, добавьте один из этих двух линий в файл config.xml:
+Это теперь можно выбрать, следует ли хранить файлы в документы или каталоге библиотеки, с предпочтением в вашем приложении `config.xml` файл. Чтобы сделать это, добавить один из этих двух линий в `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Без этой линии плагин файл будет использовать «Совместимость» по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.
+Без этой линии, будет использовать файл плагина `Compatibility` по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.
-Если ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения для «Совместимость». Переключение расположения «Библиотека» будет означать, что существующих пользователей, обновление их приложения будет не в состоянии получить доступ к их сохраненные ранее файлы.
+Если ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения `Compatibility` . Переключение расположения `Library` будет означать, что существующих пользователей обновить их применения будет не в состоянии получить доступ к их сохраненные ранее файлы.
-Если ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, параметр «Библиотека» обычно рекомендуется.
+Если ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, то `Library` как правило рекомендуется настройка.
-### Firefox OS причуды
+## Firefox OS причуды
API файловой системы изначально не поддерживается Firefox OS и реализуется как оболочка поверх indexedDB.
* Не вынимая непустые каталоги
* Не поддерживает метаданные для каталогов
-* Не поддерживает `requestAllFileSystems` и `resolveLocalFileSystemURI` методы
* Методы `copyTo` и `moveTo` не поддерживает каталоги
+Поддерживаются следующие пути данных: * `applicationDirectory` -использует `xhr` чтобы получить локальные файлы, которые упакованы с приложением. * `dataDirectory` - Для постоянных данных конкретного приложения файлов. * `cacheDirectory` -Кэшированных файлов, которые должны выжить перезагрузки приложения (Apps не следует полагаться на OS, чтобы удалить файлы из здесь).
+
## Обновление примечания
В v1.0.0 этого плагина `FileEntry` и `DirectoryEntry` структур изменились, более соответствует опубликованной спецификации.
@@ -153,7 +215,7 @@ API файловой системы изначально не поддержив
Если ваше приложение работает с устройства Абсолют путями, и ранее были получены эти пути через `fullPath` свойства `Entry` объектов, то вам следует обновить код для использования `entry.toURL()` вместо этого.
-Для обратной совместимости, `resolveLocalFileSystemURL()` метод будет принимать путь Абсолют устройства и будет возвращать `Entry` объект, соответствующий его, до тех пор, как этот файл существует в рамках временных или ПОСТОЯННЫХ файловых систем.
+Для обратной совместимости, `resolveLocalFileSystemURL()` метод будет принимать путь Абсолют устройства и будет возвращать `Entry` объект, соответствующий его, до тех пор, как этот файл существует в рамках либо `TEMPORARY` или `PERSISTENT` файловых систем.
Это особенно была проблема с плагином передачи файлов, который ранее использовался устройства Абсолют пути (и все еще может принять их). Он был обновлен для корректной работы с файловой системы URL, так что замена `entry.fullPath` с `entry.toURL()` должен решить любые вопросы, получить этот плагин для работы с файлами на устройстве.
@@ -168,18 +230,20 @@ API файловой системы изначально не поддержив
Когда возникает ошибка, один из следующих кодов будет использоваться.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Код | Постоянная |
+| ---:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Настройка плагина (опционально)
@@ -191,21 +255,21 @@ API файловой системы изначально не поддержив
### Android
-* файлов: каталог хранения внутренних файлов приложения
-* файлы внешние: каталог хранения внешний файл приложения
-* SDCard: глобальный внешний файл каталога хранения (это корень SD-карты, если таковая установлена). Вы должны иметь `android.permission.WRITE_EXTERNAL_STORAGE` разрешение использовать это.
-* кэш: Каталог внутреннего кэша приложения
-* кэш внешние: приложения внешней кэш-памяти каталога
-* Корень: все устройство файловой системы
+* `files`: Каталог для хранения внутреннего файла приложения
+* `files-external`: Каталог хранения внешнего файла приложения
+* `sdcard`: Глобальный внешний файл каталог хранения (это корень SD-карты, если таковая установлена). Вы должны иметь `android.permission.WRITE_EXTERNAL_STORAGE` разрешение использовать это.
+* `cache`: Каталог внутреннего кэша приложения
+* `cache-external`: Каталог приложения внешней кэш-памяти
+* `root`: Все устройство файловой системы
Android поддерживает также Специальный файловую систему под названием «документы», которая представляет подкаталог «/ документы /» в пределах файловой системы «файлы».
### iOS
-* Библиотека: Каталог библиотеки приложения
-* документы: документы каталога приложения
-* кэш: кэш каталога приложения
-* Пакет: пакет приложения; расположение самого приложения на диске (только для чтения)
-* Корень: все устройство файловой системы
+* `library`: Каталог библиотеки приложения
+* `documents`: Каталог документов приложения
+* `cache`: Каталог кэша приложения
+* `bundle`: Пакет приложения; расположение самого приложения на диске (только для чтения)
+* `root`: Все устройство файловой системы
-По умолчанию каталоги библиотеки и документы можно синхронизировать с iCloud. Вы можете заказать два дополнительных файловых систем, «Библиотека nosync» и «документы nosync», которые представляют собой специальный каталог не синхронизирована в пределах библиотеки или документов файловой системы.
\ No newline at end of file
+По умолчанию каталоги библиотеки и документы можно синхронизировать с iCloud. Вы также можете заказать два дополнительных файловых систем, `library-nosync` и `documents-nosync` , которые представляют Специальный каталог не синхронизируются в `/Library` или `/Documents` файловой системы.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
index e4c464a..d779a4f 100644
--- a/doc/zh/index.md
+++ b/doc/zh/index.md
@@ -63,31 +63,91 @@
自 v1.2.0，提供重要的檔案系統目錄的 Url。 每個 URL 是在表單*file:///path/to/spot/*，和可以轉換為 `DirectoryEntry` 使用`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-唯讀目錄在哪裡安裝的應用程式。（*iOS*，*安卓*)
+* `cordova.file.applicationDirectory`-唯讀目錄在哪裡安裝的應用程式。（*iOS*、*安卓*、*黑莓 10*)
-`cordova.file.applicationStorageDirectory`-應用程式的私有可寫入存儲的根。（*iOS*，*安卓*)
+* `cordova.file.applicationStorageDirectory`-根目錄下的應用程式的沙箱 ；在 iOS 上此位置是唯讀 （但特定的子目錄 [像 `/Documents` ] 都是讀寫）。 中包含的所有資料都是私有的應用程式。 （ *iOS*、*安卓*、*黑莓 10*)
-`cordova.file.dataDirectory`-把特定于應用程式的資料檔案的位置。（*iOS*，*安卓*)
+* `cordova.file.dataDirectory`資料持久性和私有資料存儲在內部記憶體使用的應用程式的沙箱內 （在安卓系統，如果你需要使用外部儲存體，使用 `.externalDataDirectory` ）。 在 iOS，此目錄不與 iCloud 同步 （使用 `.syncedDataDirectory` ）。 （*iOS*、*安卓*、*黑莓 10*)
-`cordova.file.cacheDirectory`-緩存的檔應該生存的應用程式重新開機。應用程式不應依賴的作業系統，請刪除檔在這裡。（*iOS*，*安卓*)
+* `cordova.file.cacheDirectory`-緩存的資料檔案或您的應用程式重新可以輕鬆地創建的任何檔的目錄。 作業系統可能會刪除這些檔，該設備在存儲上運行低時，然而，應用程式不應依賴的作業系統，請刪除檔在這裡。 （*iOS*、*安卓*、*黑莓 10*)
-`cordova.file.externalApplicationStorageDirectory`-應用程式外部存儲上的空間。（*iOS*，*安卓*)
+* `cordova.file.externalApplicationStorageDirectory`-應用程式外部存儲上的空間。（*安卓*)
-`cordova.file.externalDataDirectory`-放在外部存儲特定于應用程式的資料檔案的位置。（*安卓*)
+* `cordova.file.externalDataDirectory`-放在外部存儲特定于應用程式的資料檔案的位置。（*安卓*)
-`cordova.file.externalCacheDirectory`-在外部存儲應用程式緩存。（*安卓*)
+* `cordova.file.externalCacheDirectory`-在外部存儲應用程式緩存。（*安卓*)
-`cordova.file.externalRootDirectory`-外部存儲 （SD 卡） 的根。（*安卓*)
+* `cordova.file.externalRootDirectory`-外部存儲 （SD 卡） 的根。（*安卓*、*黑莓 10*)
-`cordova.file.tempDirectory`-OS 可以清除時的空目錄會。（*iOS*)
+* `cordova.file.tempDirectory`-OS 可以清除時的空目錄會。 不依賴于 OS，以清除此目錄 ；您的應用程式，應總是移除作為適用的檔。 （*iOS*)
-`cordova.file.syncedDataDirectory`-保存應同步 （例如到 iCloud） 的特定于應用程式的檔。（*iOS*)
+* `cordova.file.syncedDataDirectory`-保存應同步 （例如到 iCloud） 的特定于應用程式的檔。（*iOS*)
-`cordova.file.documentsDirectory`-檔私有的應用程式，但這是對其他的 applciations （例如 Office 檔） 有意義。（*iOS*)
+* `cordova.file.documentsDirectory`-檔私有的應用程式，但這是對其他應用程式 （例如 Office 檔） 有意義。（*iOS*)
+
+* `cordova.file.sharedDirectory`-對所有應用程式 （*黑莓 10*全域可用的檔)
+
+## 檔案系統佈局
+
+雖然技術上的實現細節，它可以是非常有用，要知道如何 `cordova.file.*` 屬性對應到真正的設備上的實體路徑。
+
+### iOS 檔案系統佈局
+
+| 設備路徑 | `cordova.file.*` | `iosExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 同步 | 私人 |
+|:------------------------------- |:--------------------------- |:--------------------- |:------:|:------:|:----------:|:---:|:--:|
+| `/ 無功/移動/應用程式/< UUID > /` | applicationStorageDirectory | - | r/o | 不適用 | 不適用 | 不適用 | 是啊 |
+| `appname.app/` | applicationDirectory | 束 | r/o | 不適用 | 不適用 | 不適用 | 是啊 |
+| `www/` | - | - | r/o | 不適用 | 不適用 | 不適用 | 是啊 |
+| `Documents/` | documentsDirectory | 檔 | r/w | 是啊 | 無 | 是啊 | 是啊 |
+| `NoCloud/` | - | 檔 nosync | r/w | 是啊 | 無 | 無 | 是啊 |
+| `Library` | - | 圖書館 | r/w | 是啊 | 無 | 是嗎？ | 是啊 |
+| `NoCloud/` | dataDirectory | 圖書館 nosync | r/w | 是啊 | 無 | 無 | 是啊 |
+| `Cloud/` | syncedDataDirectory | - | r/w | 是啊 | 無 | 是啊 | 是啊 |
+| `Caches/` | cacheDirectory | 快取記憶體 | r/w | 是啊 * | 是的 \* * *| | 無 | 是啊 |
+| `tmp/` | tempDirectory | - | r/w | 沒有 * * | 是的 \* * *| | 無 | 是啊 |
+
+* 檔堅持跨應用程式重新開機和升級，但是每當 OS 的欲望，可以清除此目錄。您的應用程式應該能夠重新創建任何內容可能會被刪除。
+
+* * 檔可能會持續整個應用程式重新開機，但不是依賴于這種行為。 不保證檔在更新之間持續存在。 您的應用程式應該從這個目錄刪除檔，在適當的時候，作為作業系統並不能保證時 （或即使） 中刪除這些檔。
+
+\* * *| OS 可能會清除此目錄的內容，每當它感覺它是必要的但不是依賴于此。 你應該清除此目錄為適合您的應用程式。
+
+### Android 的檔案系統佈局
+
+| 設備路徑 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:------:|:-----:|:------:|:--:|
+| `file:///android_asset/` | applicationDirectory | | r/o | 不適用 | 不適用 | 是啊 |
+| `/ 資料資料/< 應用程式 id > /` | applicationStorageDirectory | - | r/w | 不適用 | 不適用 | 是啊 |
+| `cache` | cacheDirectory | 快取記憶體 | r/w | 是啊 | 是啊 * | 是啊 |
+| `files` | dataDirectory | 檔 | r/w | 是啊 | 無 | 是啊 |
+| `Documents` | | 檔 | r/w | 是啊 | 無 | 是啊 |
+| `< sd 卡 > /` | externalRootDirectory | sd 卡 | r/w | 是啊 | 無 | 無 |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | 是啊 | 無 | 無 |
+| `cache` | externalCacheDirectry | 外部快取記憶體 | r/w | 是啊 | 沒有 * * | 無 |
+| `files` | externalDataDirectory | 外部檔 | r/w | 是啊 | 無 | 無 |
+
+* 的作業系統可能會定期清除此目錄中，但不是依賴于這種行為。 清除此為適合您的應用程式目錄中的內容。 使用者應手動清除緩存中，這個目錄中的內容將被刪除。
+
+* * OS 不會清除此目錄自動 ；你是負責管理你自己的內容。 使用者應手動清除緩存中，目錄中的內容將被刪除。
+
+**注意**： 如果不能裝載外部存儲， `cordova.file.external*` 屬性是`null`.
+
+### 黑莓 10 檔案系統佈局
+
+| 設備路徑 | `cordova.file.*` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |
+|:---------------------------------------------------- |:--------------------------- |:------:|:-----:|:-----:|:--:|
+| `file:///accounts/1000/appdata/ < 應用程式 id > /` | applicationStorageDirectory | r/o | 不適用 | 不適用 | 是啊 |
+| `app/native` | applicationDirectory | r/o | 不適用 | 不適用 | 是啊 |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 無 | 是啊 | 是啊 |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 是啊 | 無 | 是啊 |
+| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 是啊 | 無 | 無 |
+| `file:///accounts/1000/shared` | sharedDirectory | r/w | 是啊 | 無 | 無 |
+
+*注意*： 當應用程式部署工作週邊時，所有路徑都是相對於 /accounts/1000-enterprise。
## Android 的怪癖
-### Android 的永久存儲位置
+### Android 的持久性存儲位置
有很多有效的位置來存儲持久性檔在 Android 設備上。 請參閱[此頁][7]為廣泛地討論的各種可能性。
@@ -95,53 +155,55 @@
以前版本的外掛程式會選擇在啟動時，基於該設備是否聲稱 SD 卡 （或等效存儲分區） 展開，臨時和永久檔的位置。 如果被掛載 SD 卡，或者如果一個大的內部存儲分區是可用 （如 Nexus 設備上） 然後持久性檔將存儲在該空間的根目錄中。 這就意味著所有的科爾多瓦應用程式可以看到所有可用的檔在卡上。
-如果 SD 卡不是可用的然後以前的版本會將資料存儲在下/資料/資料 /<packageid>其中隔離應用程式從彼此，但仍然可能會導致使用者之間共用資料。
+如果 SD 卡不是可用的那麼以前的版本中將存儲資料下的 `/data/data/<packageId>` ，其中隔離應用程式從彼此，但仍可能導致使用者之間共用的資料。
-現在可以選擇是否將檔存儲在內部檔存儲位置，或使用以前的邏輯，與您的應用程式的 config.xml 檔中的偏好。 要做到這一點，向 config.xml 添加以下兩行之一：
+現在可以選擇是否將檔存儲在內部檔存儲位置，或使用以前的邏輯，在您的應用程式的偏好與 `config.xml` 檔。 要做到這一點，添加到這兩條線之一 `config.xml` ：
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-如果這條線，沒有檔外掛程式將作為預設值使用"相容性"。如果首選項標記是存在，並不是這些值之一，應用程式將無法啟動。
+如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果偏好的標記是存在的並不是這些值之一，應用程式將無法啟動。
-如果您的應用程式先前已經運送到使用者，使用較舊的 (預 1.0) 的這個外掛程式版本和已存儲的檔中的持久性的檔案系統，然後您應該設置的首選項的"相容性"。 切換到"內部"的位置就意味著現有使用者升級他們的應用程式可能無法訪問他們以前存儲的檔，他們的設備。
+如果您的應用程式先前已經運送到使用者，使用較舊的 （預 1.0） 的這個外掛程式，版本和已存儲的檔中的持久性的檔案系統，然後您應該將首選項設置為 `Compatibility` 。 切換到"內部"的位置就意味著現有使用者升級他們的應用程式可能無法訪問他們以前存儲的檔，他們的設備。
-如果您的應用程式是新的或以前從未有持久性檔案系統中存儲檔，然後，通常建議的"內部"的設置。
+如果您的應用程式是新的或有以前從未存儲檔在持久性的檔案系統，然後 `Internal` 一般建議設置。
## iOS 的怪癖
+* `cordova.file.applicationStorageDirectory`是唯讀的 ；試圖存儲內的根目錄中的檔將會失敗。 使用的另一個 `cordova.file.*` 為 iOS 定義的屬性 （只有 `applicationDirectory` 和 `applicationStorageDirectory` 都是唯讀）。
* `FileReader.readAsText(blob, encoding)`
- * `encoding`參數不受支援，和 utf-8 編碼總是有效。
+ * `encoding`參數不受支援，而 utf-8 編碼總是效果。
### iOS 的持久性存儲位置
有兩個有效的位置來存儲持久性的 iOS 設備上的檔： 檔目錄和庫目錄。 以前版本的外掛程式永遠只能存儲持久性檔在檔目錄中。 這有副作用 — — 使所有的應用程式的檔可見在 iTunes 中，往往是意料之外，尤其是對於處理大量小檔的應用程式，而不是生產用於出口，是意欲的目的的目錄的完整文檔。
-現在可以選擇是否將檔存儲在檔或庫目錄，與您的應用程式的 config.xml 檔中的偏好。 要做到這一點，向 config.xml 添加以下兩行之一：
+現在可以選擇是否將檔存儲在檔或庫目錄，在您的應用程式的偏好與 `config.xml` 檔。 要做到這一點，添加到這兩條線之一 `config.xml` ：
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-如果這條線，沒有檔外掛程式將使用"相容性"作為預設值。如果偏好的標記是存在的並不是這些值之一，應用程式將無法啟動。
+如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果偏好的標記是存在的並不是這些值之一，應用程式將無法啟動。
-如果您的應用程式先前已經運送到使用者，使用較舊的 （預 1.0） 的這個外掛程式，版本和已存儲的檔中的持久性的檔案系統，那麼您應該設置為"相容性"的偏好。 切換到"庫"的位置就意味著現有使用者升級他們的應用程式將無法訪問他們以前存儲的檔。
+如果您的應用程式先前已經運送到使用者，使用較舊的 （預 1.0） 的這個外掛程式，版本和已存儲的檔中的持久性的檔案系統，然後您應該將首選項設置為 `Compatibility` 。 切換到的位置 `Library` 意味著現有使用者升級他們的應用程式將無法訪問他們以前存儲的檔。
-如果您的應用程式是新的或以前從未有持久性檔案系統中存儲檔，然後一般建議使用"庫"設置。
+如果您的應用程式是新的或有以前從未存儲檔在持久性的檔案系統，然後 `Library` 一般建議設置。
-### 火狐瀏覽器作業系統的怪癖
+## 火狐瀏覽器作業系統的怪癖
檔案系統 API 本身不支援通過 Firefox OS，作為墊片在 indexedDB 上實現的。
* 不會失敗時刪除非空的目錄
-* 不支援用中繼資料的目錄
-* 不支援 `requestAllFileSystems` 和 `resolveLocalFileSystemURI` 的方法
+* 不支援中繼資料的目錄
* 方法 `copyTo` 和 `moveTo` 不支援目錄
-## 升級說明
+支援以下資料路徑： * `applicationDirectory` -使用 `xhr` 來獲得與該應用程式打包的本地檔。 * `dataDirectory` -為持久性的特定于應用程式的資料檔案。 * `cacheDirectory` -緩存的檔應該生存重新開機應用程式 （應用程式不應依賴的作業系統，請刪除檔在這裡）。
+
+## 升級筆記
在這個外掛程式，v1.0.0 `FileEntry` 和 `DirectoryEntry` 結構已經改變，更符合已發佈的規範。
@@ -160,7 +222,7 @@
如果您的應用程式與設備-絕對路徑，和你以前檢索到這些路徑通過 `fullPath` 屬性的 `Entry` 物件，然後您應該更新代碼以使用 `entry.toURL()` 相反。
-為向後相容性， `resolveLocalFileSystemURL()` 方法將接受設備-絕對路徑，並將返回 `Entry` 對應于它，只要該檔存在內的臨時或永久性的檔案系統物件。
+為向後相容性， `resolveLocalFileSystemURL()` 方法將接受設備-絕對路徑，並將返回 `Entry` 對應于它，只要該檔存在內任一物件 `TEMPORARY` 或 `PERSISTENT` 的檔案系統。
這特別是一直與檔案傳輸外掛程式，以前使用過的設備-絕對路徑的問題 (和仍然可以接受他們)。 它已更新正常工作與檔案系統的 Url，所以更換 `entry.fullPath` 與 `entry.toURL()` 應解決獲取該外掛程式來處理檔在設備上的任何問題。
@@ -175,18 +237,20 @@ V1.1.0 的傳回值中的 `toURL()` 被更改 （見 [CB-6394] （HTTPs://issues
當拋出一個錯誤時，將使用以下代碼之一。
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| 代碼 | 恒 |
+| --:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## 配置的外掛程式 （可選）
@@ -196,23 +260,23 @@ V1.1.0 的傳回值中的 `toURL()` 被更改 （見 [CB-6394] （HTTPs://issues
<preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root" />
-### Android 系統
+### 安卓系統
-* 檔: 應用程式的內部檔存儲目錄
-* 檔外部： 應用程式的外部檔存儲目錄
-* sdcard： 全球外部檔存儲目錄 （如果安裝了一個，這是 SD 卡的根目錄）。 您必須具有 `android.permission.WRITE_EXTERNAL_STORAGE` 使用此許可權。
-* 快取記憶體： 應用程式的內部緩存目錄
-* 外部快取記憶體： 應用程式的外部快取記憶體目錄
-* 根： 整個設備的檔案系統
+* `files`： 應用程式的內部檔存儲目錄
+* `files-external`： 應用程式的外部檔存儲目錄
+* `sdcard`： （這是根的 SD 卡，如果其中一個安裝） 全球外部檔存儲目錄。 您必須具有 `android.permission.WRITE_EXTERNAL_STORAGE` 使用此許可權。
+* `cache`： 應用程式的內部緩存目錄
+* `cache-external`： 應用程式的外部快取記憶體目錄
+* `root`： 整個設備的檔案系統
安卓系統還支援一個特別的檔案系統命名為"檔"，它代表"檔"的檔案系統中的子目錄"/ 檔 /"。
### iOS
-* 圖書館： 應用程式的庫目錄
-* 文檔： 應用程式的檔目錄
-* 快取記憶體： 應用程式的緩存目錄
-* 束： 束應用程式的 ；應用程式本身 （唯讀） 的磁片上的位置
-* 根： 整個設備的檔案系統
+* `library`： 應用程式的庫目錄
+* `documents`： 應用程式的檔目錄
+* `cache`： 應用程式的緩存目錄
+* `bundle`： 應用程式的包 ；應用程式本身 （唯讀） 的磁片上的位置
+* `root`： 整個設備的檔案系統
-預設情況下，圖書館和檔目錄可以同步到 iCloud。 您也可以要求兩個附加檔案系統、"圖書館 nosync"和"文檔-nosync"，所代表的庫或檔的檔案系統內的一個特殊非同步目錄。
\ No newline at end of file
+預設情況下，圖書館和檔目錄可以同步到 iCloud。 您也可以要求兩個額外的檔案系統， `library-nosync` 和 `documents-nosync` ，它代表一個特殊的非同步目錄內 `/Library` 或 `/Documents` 檔案系統。
\ No newline at end of file
[2/3] CB-7249cordova-plugin-file documentation translation:
cordova-plugin-file
Posted by ld...@apache.org.
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
index a374e20..1b6c53e 100644
--- a/doc/it/index.md
+++ b/doc/it/index.md
@@ -56,27 +56,87 @@ Per una panoramica delle altre opzioni di archiviazione, consultare [Guida di ar
A partire dalla v 1.2.0, vengono forniti gli URL per le directory importanti file di sistema. Ogni URL è nella forma *file:///path/to/spot/*e può essere convertito in un `DirectoryEntry` utilizzando`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Sola lettura directory dove è installato l'applicazione. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Sola lettura directory dove è installato l'applicazione. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.applicationStorageDirectory`-Radice di ammasso scrivibile privato dell'app. (*iOS*, *Android*)
+* `cordova.file.applicationStorageDirectory`-Directory radice di sandbox dell'applicazione; su iOS questa posizione è in sola lettura (ma sottodirectory specifiche [come `/Documents` ] sono di sola lettura). Tutti i dati contenuti all'interno è privato all'app. ( *iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.dataDirectory`-Dove mettere i file di dati specifici di app. (*iOS*, *Android*)
+* `cordova.file.dataDirectory`-Archiviazione dati persistente e privati nella sandbox dell'applicazione utilizzando la memoria interna (su Android, se è necessario utilizzare la memoria esterna, utilizzare `.externalDataDirectory` ). IOS, questa directory non è sincronizzata con iCloud (utilizzare `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-I file che dovrebbero sopravvivere si riavvia app nella cache. Apps non devono basarsi sull'OS di eliminare i file qui. (*iOS*, *Android*)
+* `cordova.file.cacheDirectory`-Directory per i file memorizzati nella cache di dati o qualsiasi file che app possibile ricreare facilmente. L'OS può eliminare questi file quando il dispositivo viene eseguito basso sull'archiviazione, tuttavia, apps non deve basarsi sul sistema operativo per cancellare i file qui. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.externalApplicationStorageDirectory`-Spazio applicazione su storage esterno. (*iOS*, *Android*)
+* `cordova.file.externalApplicationStorageDirectory`-Spazio applicazione su storage esterno. (*Android*)
-`cordova.file.externalDataDirectory`-Dove mettere i file di dati specifico app su storage esterno. (*Android*)
+* `cordova.file.externalDataDirectory`-Dove mettere i file di dati specifico app su storage esterno. (*Android*)
-`cordova.file.externalCacheDirectory`-Cache applicazione su storage esterno. (*Android*)
+* `cordova.file.externalCacheDirectory`-Cache applicazione su storage esterno. (*Android*)
-`cordova.file.externalRootDirectory`-Radice di archiviazione esterna (scheda SD). (*Android*)
+* `cordova.file.externalRootDirectory`-Radice di archiviazione esterna (scheda SD). (*Android*, *BlackBerry, 10*)
-`cordova.file.tempDirectory`-Temp directory che l'OS è possibile cancellare a volontà. (*iOS*)
+* `cordova.file.tempDirectory`-Temp directory che l'OS è possibile cancellare a volontà. Non fare affidamento sul sistema operativo per cancellare questa directory; l'app deve sempre rimuovere file come applicabile. (*iOS*)
-`cordova.file.syncedDataDirectory`-Contiene i file app specifiche che devono essere sincronizzati (per esempio a iCloud). (*iOS*)
+* `cordova.file.syncedDataDirectory`-Contiene i file app specifiche che devono essere sincronizzati (per esempio a iCloud). (*iOS*)
-`cordova.file.documentsDirectory`-I file privati per le app, ma che sono significativi per altri nonché (ad es. file di Office). (*iOS*)
+* `cordova.file.documentsDirectory`-I file privati per le app, ma che sono significativi per altre applicazioni (ad esempio i file di Office). (*iOS*)
+
+* `cordova.file.sharedDirectory`-File disponibili globalmente a tutte le applicazioni (*BlackBerry 10*)
+
+## Layout dei file di sistema
+
+Anche se tecnicamente un dettaglio di implementazione, può essere molto utile per conoscere come la `cordova.file.*` Proprietà mappa per percorsi fisici su un dispositivo reale.
+
+### iOS File sistema Layout
+
+| Percorso dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | r/w? | persistente? | OS cancella | sincronizzazione | privato |
+|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:------------:|:-----------:|:----------------:|:-------:|
+| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r/o | N/A | N/A | N/A | Sì |
+| `appname.app/` | applicationDirectory | bundle | r/o | N/A | N/A | N/A | Sì |
+| `www/` | - | - | r/o | N/A | N/A | N/A | Sì |
+| `Documents/` | documentsDirectory | documenti | r/w | Sì | No | Sì | Sì |
+| `NoCloud/` | - | nosync-documenti | r/w | Sì | No | No | Sì |
+| `Library` | - | libreria | r/w | Sì | No | Sì? | Sì |
+| `NoCloud/` | dataDirectory | nosync-libreria | r/w | Sì | No | No | Sì |
+| `Cloud/` | syncedDataDirectory | - | r/w | Sì | No | Sì | Sì |
+| `Caches/` | cacheDirectory | cache | r/w | Sì * | Sì \* * *| | No | Sì |
+| `tmp/` | tempDirectory | - | r/w | No * * | Sì \* * *| | No | Sì |
+
+* File persistono attraverso riavvii app e aggiornamenti, ma questa directory può essere azzerata ogni volta che desideri l'OS. L'app dovrebbe essere in grado di ricreare qualsiasi contenuto che potrebbe essere eliminato.
+
+* * File può persistere attraverso app riavvii, ma non fare affidamento su questo comportamento. I file non sono garantiti a persistere attraverso gli aggiornamenti. L'app deve rimuovere i file dalla directory quando è applicabile, come il sistema operativo non garantisce quando (o anche se) questi file vengono rimossi.
+
+\* * *| Il sistema operativo può cancellare il contenuto di questa directory ogni volta che si sente è necessario, ma non fare affidamento su questo. Si dovrebbe cancellare questa directory come adatto per l'applicazione.
+
+### Layout sistema Android File
+
+| Percorso dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w? | persistente? | OS cancella | privato |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:------------:|:-----------:|:-------:|
+| `File:///android_asset/` | applicationDirectory | | r/o | N/A | N/A | Sì |
+| `< app-id > /dati/dati / /` | applicationStorageDirectory | - | r/w | N/A | N/A | Sì |
+| `cache` | cacheDirectory | cache | r/w | Sì | Sì * | Sì |
+| `files` | dataDirectory | file | r/w | Sì | No | Sì |
+| `Documents` | | documenti | r/w | Sì | No | Sì |
+| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sì | No | No |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Sì | No | No |
+| `cache` | externalCacheDirectry | cache-esterno | r/w | Sì | No * * | No |
+| `files` | externalDataDirectory | file-esterno | r/w | Sì | No | No |
+
+* Il sistema operativo può cancellare periodicamente questa directory, ma non fare affidamento su questo comportamento. Cancellare il contenuto di questa directory come adatto per l'applicazione. Il contenuto di questa directory dovrebbe un utente eliminare manualmente la cache, vengono rimossi.
+
+* * Il sistema operativo non cancella questa directory automaticamente; Tu sei responsabile per la gestione dei contenuti da soli. Il contenuto della directory dovrebbe l'utente eliminare manualmente la cache, vengono rimossi.
+
+**Nota**: se la memorizzazione esterna non può essere montato, il `cordova.file.external*` sono di proprietà`null`.
+
+### BlackBerry 10 File sistema Layout
+
+| Percorso dispositivo | `Cordova.file.*` | r/w? | persistente? | OS cancella | privato |
+|:--------------------------------------------------- |:--------------------------- |:----:|:------------:|:-----------:|:-------:|
+| `File:///accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r/o | N/A | N/A | Sì |
+| `app/native` | applicationDirectory | r/o | N/A | N/A | Sì |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sì | Sì |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sì | No | Sì |
+| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sì | No | No |
+| `File:///accounts/1000/Shared` | sharedDirectory | r/w | Sì | No | No |
+
+*Nota*: quando l'applicazione viene distribuita a lavorare perimetrale, tutti i percorsi sono relativi a /accounts/1000-enterprise.
## Stranezze Android
@@ -88,23 +148,24 @@ Ci sono più percorsi validi per memorizzare i file persistenti su un dispositiv
Versioni precedenti del plugin avrebbe scelto il percorso dei file temporanei e permanenti su avvio, in base se il dispositivo ha sostenuto che la scheda SD (o partizione storage equivalente) è stato montato. Se è stata montata sulla scheda SD o una partizione di storage interno grande era disponibile (come sui dispositivi Nexus,) allora saranno memorizzati i file persistenti nella radice di quello spazio. Questo significava che tutte le apps di Cordova poteva vedere tutti i file disponibili sulla carta.
-Se la scheda SD non era disponibile, versioni precedenti vuoi memorizzare dati sotto /dati/dati /<packageid>, che isola i apps da altro, ma possono ancora causare dati da condividere tra gli utenti.
+Se la scheda SD non era disponibile, poi versioni precedenti vuoi memorizzare dati sotto `/data/data/<packageId>` , che isola i apps da altro, ma può ancora causa dati da condividere tra gli utenti.
-Ora è possibile scegliere se memorizzare i file nel percorso di archiviazione di file interno o utilizzando la logica precedente, con una preferenza nel file config. XML dell'applicazione. Per fare questo, aggiungere una di queste due linee al file config. xml:
+Ora è possibile scegliere se memorizzare i file nel percorso di archiviazione di file interno o utilizzando la logica precedente, con una preferenza nell'applicazione `config.xml` file. A tale scopo, aggiungere una di queste due linee di `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Senza questa linea, il File del plugin utilizzerà "Compatibilità" come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.
+Senza questa linea, si utilizzerà il File del plugin `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.
-Se l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza alla "Compatibilità". La posizione su "Interno" di commutazione significherebbe che gli utenti esistenti che aggiornare la loro applicazione potrebbero essere Impossibile accedere ai loro file precedentemente memorizzati, a seconda del loro dispositivo.
+Se l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, quindi è necessario impostare la preferenza di `Compatibility` . La posizione su "Interno" di commutazione significherebbe che gli utenti esistenti che aggiornare la loro applicazione potrebbero essere Impossibile accedere ai loro file precedentemente memorizzati, a seconda del loro dispositivo.
-Se l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione "interno".
+Se l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, poi il `Internal` impostazione è generalmente raccomandato.
## iOS stranezze
+* `cordova.file.applicationStorageDirectory`è di sola lettura; tentativo di memorizzare i file all'interno della directory radice avrà esito negativo. Utilizzare uno degli altri `cordova.file.*` proprietà definite per iOS (solo `applicationDirectory` e `applicationStorageDirectory` sono di sola lettura).
* `FileReader.readAsText(blob, encoding)`
* Il `encoding` parametro non è supportato, e codifica UTF-8 è sempre attivo.
@@ -112,28 +173,29 @@ Se l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel file
Ci sono due percorsi validi per memorizzare i file persistenti su un dispositivo iOS: la directory documenti e la biblioteca. Precedenti versioni del plugin archiviati solo mai persistenti file nella directory documenti. Questo ha avuto l'effetto collaterale di tutti i file di un'applicazione che rende visibili in iTunes, che era spesso involontaria, soprattutto per le applicazioni che gestiscono un sacco di piccoli file, piuttosto che produrre documenti completi per l'esportazione, che è la destinazione della directory.
-Ora è possibile scegliere se memorizzare i file nella directory di libreria, con una preferenza nel file config. XML dell'applicazione o documenti. Per fare questo, aggiungere una di queste due linee al file config. xml:
+Ora è possibile scegliere se memorizzare i file nella directory di libreria, con una preferenza nella vostra applicazione o documenti `config.xml` file. A tale scopo, aggiungere una di queste due linee di `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Senza questa linea, il File del plugin utilizzerà "Compatibilità" come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.
+Senza questa linea, si utilizzerà il File del plugin `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.
-Se l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza alla "Compatibilità". La posizione di "Libreria" di commutazione significherebbe che gli utenti esistenti che aggiornare la loro applicazione è in grado di accedere ai loro file precedentemente memorizzati.
+Se l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, quindi è necessario impostare la preferenza di `Compatibility` . Il percorso per il passaggio `Library` significherebbe che gli utenti esistenti che aggiornare la loro applicazione è in grado di accedere ai loro file precedentemente memorizzati.
-Se l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione "Libreria".
+Se l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, poi il `Library` impostazione è generalmente raccomandato.
-### Firefox OS stranezze
+## Firefox OS stranezze
L'API di sistema del File non è supportato nativamente dal sistema operativo Firefox e viene implementato come uno spessore in cima indexedDB.
* Non manca quando si rimuove le directory non vuota
* Non supporta i metadati per le directory
-* Non supporta `requestAllFileSystems` e `resolveLocalFileSystemURI` metodi
* Metodi `copyTo` e `moveTo` non supporta le directory
+Sono supportati i seguenti percorsi di dati: * `applicationDirectory` -utilizza `xhr` per ottenere i file locali che sono confezionati con l'app. * `dataDirectory` - Per i file di dati persistenti app specifiche. * `cacheDirectory` -Cache file che dovrebbero sopravvivere si riavvia app (applicazioni non devono basarsi sull'OS di eliminare i file qui).
+
## Note di aggiornamento
In v 1.0.0 di questo plugin, il `FileEntry` e `DirectoryEntry` strutture sono cambiati, per essere più in linea con le specifiche pubblicate.
@@ -153,7 +215,7 @@ Con v 1.0.0, la `fullPath` attributo è il percorso del file, *rispetto alla rad
Se l'applicazione funziona con dispositivo-assoluto-percorsi, e estratto in precedenza tali percorsi attraverso la `fullPath` proprietà di `Entry` oggetti, allora si dovrebbe aggiornare il codice per utilizzare `entry.toURL()` invece.
-Per indietro compatibilità, il `resolveLocalFileSystemURL()` Metodo accetterà un dispositivo-assoluto-percorso e restituirà un `Entry` oggetto corrispondente ad essa, fintanto che il file esiste all'interno del filesystem temporaneo o permanente.
+Per indietro compatibilità, il `resolveLocalFileSystemURL()` Metodo accetterà un dispositivo-assoluto-percorso e restituirà un `Entry` oggetto corrispondente ad essa, finché quel file esiste all'interno sia il `TEMPORARY` o `PERSISTENT` filesystem.
Questo particolare è stato un problema con il plugin di trasferimento File, che in precedenza utilizzati percorsi-dispositivo-assoluto (e ancora può accoglierli). Esso è stato aggiornato per funzionare correttamente con gli URL di FileSystem, così sostituendo `entry.fullPath` con `entry.toURL()` dovrebbe risolvere eventuali problemi ottenendo quel plugin per lavorare con i file nel dispositivo.
@@ -168,18 +230,20 @@ che può essere utilizzato per identificare univocamente il file.
Quando viene generato un errore, uno dei seguenti codici da utilizzare.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Codice | Costante |
+| ------:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Configurare il Plugin (opzionale)
@@ -191,21 +255,21 @@ Il set di filesystem disponibili può essere configurato per ogni piattaforma. S
### Android
-* File: directory di archiviazione di file interno dell'applicazione
-* file-esterno: directory di archiviazione dell'applicazione file esterno
-* sdcard: la directory di archiviazione di file esterni globale (questa è la radice della scheda SD, se uno è installato). Deve avere il `android.permission.WRITE_EXTERNAL_STORAGE` il permesso di usare questo.
-* cache: la cache interna directory applicazione
-* cache-esterno: directory di cache esterna dell'applicazione
-* radice: il dispositivo intero filesystem
+* `files`: Directory di archiviazione di file interno dell'applicazione
+* `files-external`: Directory di archiviazione dell'applicazione il file esterno
+* `sdcard`: La directory di archiviazione di file esterni globale (questa è la radice della scheda SD, se uno è installato). Deve avere il `android.permission.WRITE_EXTERNAL_STORAGE` il permesso di usare questo.
+* `cache`: La directory dell'applicazione cache interna
+* `cache-external`: La directory dell'applicazione cache esterna
+* `root`: Dispositivo intero filesystem
Android supporta anche un filesystem speciale denominato "documenti", che rappresenta una sottodirectory "/ documenti /" all'interno del filesystem "files".
### iOS
-* Biblioteca: la directory dell'applicazione libreria
-* documenti: la directory dell'applicazione documenti
-* cache: la Cache directory applicazione
-* bundle: bundle dell'applicazione; la posizione dell'app sul disco (sola lettura)
-* radice: il dispositivo intero filesystem
+* `library`: La directory dell'applicazione libreria
+* `documents`: La directory dell'applicazione documenti
+* `cache`: La directory dell'applicazione Cache
+* `bundle`: Bundle dell'applicazione; la posizione dell'app sul disco (sola lettura)
+* `root`: Dispositivo intero filesystem
-Per impostazione predefinita, la directory di libreria e documenti può essere sincronizzata a iCloud. È anche possibile richiedere due filesystem aggiuntivi, "biblioteca-nosync" e "documenti-nosync", che rappresentano una speciale directory non sincronizzati entro il filesystem libreria o documenti.
\ No newline at end of file
+Per impostazione predefinita, la directory di libreria e documenti può essere sincronizzata a iCloud. È anche possibile richiedere due filesystem aggiuntivi, `library-nosync` e `documents-nosync` , che rappresentano una speciale directory non sincronizzati entro il `/Library` o `/Documents` filesystem.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
index 623931a..1938e1b 100644
--- a/doc/ja/index.md
+++ b/doc/ja/index.md
@@ -56,27 +56,87 @@ FileWriter 仕様も実装しています: <http://dev.w3.org/2009/dap/file-syst
V1.2.0、現在重要なファイル システム ディレクトリへの Url を提供しています。 各 URL はフォーム*file:///path/to/spot/*に変換することができます、 `DirectoryEntry` を使用して`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-読み取り専用のディレクトリは、アプリケーションがインストールされています。（*iOS*、*アンドロイド*)
+* `cordova.file.applicationDirectory`-読み取り専用のディレクトリは、アプリケーションがインストールされています。（*iOS*、*アンドロイド*、*ブラックベリー 10*)
-`cordova.file.applicationStorageDirectory`-アプリのプライベートの書き込み可能な記憶域のルートです。（*iOS*、*アンドロイド*)
+* `cordova.file.applicationStorageDirectory`-アプリケーションのサンド ボックス; のルート ディレクトリiOS でこの場所が読み取り専用 （特定のサブディレクトリが [のような `/Documents` ] は、読み取り/書き込み)。 内に含まれるすべてのデータは、アプリケーションにプライベートです。 （ *iOS*、*アンドロイド*、*ブラックベリー 10*)
-`cordova.file.dataDirectory`-どこにアプリケーション固有のデータ ファイルを置きます。（*iOS*、*アンドロイド*)
+* `cordova.file.dataDirectory`内部メモリを使用して、アプリケーションのサンド ボックス内で永続なプライベート データ ストレージ （外部メモリを使用する必要がある場合使用して Android 上で `.externalDataDirectory` )。 IOS は、このディレクトリは iCloud と同期されません (使用する `.syncedDataDirectory` )。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)
-`cordova.file.cacheDirectory`-キャッシュのファイルをアプリケーションの再起動後も維持する必要があります。アプリは、ここでファイルを削除する OS 依存しないでください。（*iOS*、*アンドロイド*)
+* `cordova.file.cacheDirectory`-キャッシュされたデータ ファイルやアプリに簡単に再作成できる任意のファイルのディレクトリ。 ストレージ デバイスが不足したときに、OS がこれらのファイルを削除可能性があります、それにもかかわらず、アプリはここにファイルを削除する OS に依存しないでください。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)
-`cordova.file.externalApplicationStorageDirectory`外部ストレージのアプリケーション領域。（*iOS*、*アンドロイド*)
+* `cordova.file.externalApplicationStorageDirectory`外部ストレージのアプリケーション領域。（*アンドロイド*)
-`cordova.file.externalDataDirectory`-外部ストレージ上のアプリ固有のデータ ファイルを配置する場所。（*アンドロイド*)
+* `cordova.file.externalDataDirectory`-外部ストレージ上のアプリ固有のデータ ファイルを配置する場所。（*アンドロイド*)
-`cordova.file.externalCacheDirectory`外部ストレージにアプリケーション キャッシュ。（*アンドロイド*)
+* `cordova.file.externalCacheDirectory`外部ストレージにアプリケーション キャッシュ。（*アンドロイド*)
-`cordova.file.externalRootDirectory`-外部ストレージ (SD カード) ルート。（*アンドロイド*)
+* `cordova.file.externalRootDirectory`-外部ストレージ (SD カード) ルート。（*アンドロイド*、*ブラックベリー 10*)
-`cordova.file.tempDirectory`-OS をクリアすることができます temp ディレクトリが。(*iOS*)
+* `cordova.file.tempDirectory`-OS をクリアすることができます temp ディレクトリが。 このディレクトリ; オフに OS に依存しません。アプリが常に該当するファイルを削除します。 (*iOS*)
-`cordova.file.syncedDataDirectory`-（例えば iCloud) に同期する必要がありますアプリケーション固有のファイルを保持します。(*iOS*)
+* `cordova.file.syncedDataDirectory`-（例えば iCloud) に同期する必要がありますアプリケーション固有のファイルを保持します。(*iOS*)
-`cordova.file.documentsDirectory`-ファイル、アプリがプライベート他行われなくなります (Office ファイルなど） には意味が。(*iOS*)
+* `cordova.file.documentsDirectory`-ファイル、アプリケーションにプライベートは他のアプリケーション (Office ファイルなど） を意味です。(*iOS*)
+
+* `cordova.file.sharedDirectory`すべてのアプリケーション (*ブラックベリー 10*にグローバルに使用できるファイル)
+
+## ファイル ・ システム ・ レイアウト
+
+非常に知っておくと便利することができますが技術的に実装の詳細、どのように、 `cordova.file.*` プロパティを実際のデバイス上の物理パスにマップ。
+
+### iOS ファイル システムのレイアウト
+
+| デバイス ・ パス | `cordova.file.*` | `iosExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | 同期 | プライベート |
+|:------------------------------------ |:--------------------------- |:--------------------- |:--------:|:--------:|:----------:|:------:|:------:|
+| `/var/モバイル/アプリケーション/< UUID >/` | applicationStorageDirectory | - | r/o | N/A | N/A | N/A | はい |
+| `appname.app/` | ディレクトリ | バンドル | r/o | N/A | N/A | N/A | はい |
+| `www/` | - | - | r/o | N/A | N/A | N/A | はい |
+| `Documents/` | documentsDirectory | ドキュメント | r/w | はい | いいえ | はい | はい |
+| `NoCloud/` | - | ドキュメント nosync | r/w | はい | いいえ | いいえ | はい |
+| `Library` | - | ライブラリ | r/w | はい | いいえ | はいですか？ | はい |
+| `NoCloud/` | dataDirectory | ライブラリ nosync | r/w | はい | いいえ | いいえ | はい |
+| `Cloud/` | syncedDataDirectory | - | r/w | はい | いいえ | はい | はい |
+| `Caches/` | cacheDirectory | キャッシュ | r/w | はい * | はい \* * *| | いいえ | はい |
+| `tmp/` | tempDirectory | - | r/w | いいえ * * | はい \* * *| | いいえ | はい |
+
+* アプリを再起動し、アップグレードとの間でファイルを保持が、OS を希望するたびにこのディレクトリを削除することができます。アプリを削除可能性があります任意のコンテンツを再作成することができる必要があります。
+
+* * ファイル アプリケーション再起動を渡って続くことがありますが、この動作に依存しないでください。 ファイルは、更新を維持するは保証されません。 アプリが該当する場合このディレクトリからファイルを削除する必要があります、これらのファイルが削除されるとき (または場合でも)、OS は保証しません。
+
+\* * *| OS はそれ、必要だと感じているときにこのディレクトリの内容を消去可能性がありますが、これに依存しません。 この適切なディレクトリに、アプリケーションをオフにする必要があります。
+
+### 人造人間ファイル ・ システム ・ レイアウト
+
+| デバイス ・ パス | `cordova.file.*` | `AndroidExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:--------:|:--------:|:---------:|:------:|
+| `file:///android_asset/` | ディレクトリ | | r/o | N/A | N/A | はい |
+| `/データ/データ/< app id >/` | applicationStorageDirectory | - | r/w | N/A | N/A | はい |
+| `cache` | cacheDirectory | キャッシュ | r/w | はい | はい * | はい |
+| `files` | dataDirectory | ファイル | r/w | はい | いいえ | はい |
+| `Documents` | | ドキュメント | r/w | はい | いいえ | はい |
+| `< sd カード >/` | externalRootDirectory | sd カード | r/w | はい | いいえ | いいえ |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | はい | いいえ | いいえ |
+| `cache` | externalCacheDirectry | 外部キャッシュ | r/w | はい | いいえ * * | いいえ |
+| `files` | externalDataDirectory | 外部ファイル | r/w | はい | いいえ | いいえ |
+
+* OS このディレクトリを定期的に消去可能性がありますが、この動作に依存しないでください。 アプリケーションの必要に応じてこのディレクトリの内容をオフにします。 ユーザーは手動でキャッシュを削除する必要があります、このディレクトリの内容が削除されます。
+
+* * OS はこのディレクトリは自動的にクリアされません自分でコンテンツを管理するために責任があります。 ユーザは手動でキャッシュを消去する必要があります、ディレクトリの内容が削除されます。
+
+**注**: 外部記憶装置をマウントできない場合、 `cordova.file.external*` プロパティは、`null`.
+
+### ブラックベリー 10 ファイル ・ システム ・ レイアウト
+
+| デバイス ・ パス | `cordova.file.*` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |
+|:------------------------------------------------- |:--------------------------- |:--------:|:--------:|:---------:|:------:|
+| `file:///accounts/1000/appdata/< app id >/` | applicationStorageDirectory | r/o | N/A | N/A | はい |
+| `app/native` | ディレクトリ | r/o | N/A | N/A | はい |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | いいえ | はい | はい |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | はい | いいえ | はい |
+| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | はい | いいえ | いいえ |
+| `file:///accounts/1000/shared` | sharedDirectory | r/w | はい | いいえ | いいえ |
+
+*注*: すべてのパスは/accounts/1000-enterprise 基準に境界を動作するようにアプリケーションを展開するとき。
## Android の癖
@@ -88,23 +148,24 @@ Android のデバイスに永続的なファイルを格納する複数の有効
以前のバージョンのプラグインは、デバイスの SD カード （または同等のストレージ パーティション） マウントされていたと主張したかどうかに基づいて、起動時に一時と永続的なファイルの場所を選ぶでしょう。 SD カードがマウントされている場合、または大規模な内部ストレージ パーティションが利用可能な場合 (ようネクサス デバイス上） し、永続的なファイルは、その領域のルートに格納されます。 これはすべての Cordova アプリ見ることができる利用可能なファイルのすべてのカードに意味しました。
-SD カードが利用できない場合、以前のバージョン取得データを保存/データ/データの下<packageid>、アプリ、互いからの分離がまだユーザー間で共有するデータを引き起こす可能性があります。
+SD カードがない場合、以前のバージョンがデータを格納する `/data/data/<packageId>` が分離、お互いからアプリがまだ原因をユーザー間で共有されるデータ。
-内部ファイルの保存場所やアプリケーションの config.xml ファイルに優先順位を持つ以前のロジックを使用してファイルを保存するかどうかを選択することが可能です今。 これを行うに、config.xml に次の 2 行のいずれかを追加します。
+内部ファイルの保存場所やアプリケーションの優先順位以前のロジックを使用してファイルを保存するかどうかを選択することは今 `config.xml` ファイル。 これを行うに、追加する次の 2 行のいずれか `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-この行がなければファイル プラグインは既定値として「互換性」を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
+この行がなければファイルのプラグインが使用する `Compatibility` 、デフォルトとして。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
-アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには「互換性」を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを彼らの装置によって、以前に保存されたファイルにアクセスすることができることがあることを意味する「内部」に場所をスイッチングします。
+アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用してこのプラグインのバージョンは、永続的なファイルシステムに保存されているファイルしに優先順位を設定する必要があります `Compatibility` 。 自分のアプリケーションをアップグレードする既存のユーザーを彼らの装置によって、以前に保存されたファイルにアクセスすることができることがあることを意味する「内部」に場所をスイッチングします。
-アプリケーション場合は、新しい、または永続的なファイルシステムにファイルが格納され以前は決して、「内部」の設定は推奨一般に。
+場合は、アプリケーションが新しい、または永続的なファイルシステムにファイルが格納され決して以前し、 `Internal` の設定は一般にお勧めします。
## iOS の癖
+* `cordova.file.applicationStorageDirectory`読み取り専用;ルート ディレクトリ内のファイルを保存しようは失敗します。 他の 1 つを使用して `cordova.file.*` iOS のため定義されているプロパティ (のみ `applicationDirectory` と `applicationStorageDirectory` は読み取り専用)。
* `FileReader.readAsText(blob, encoding)`
* `encoding`パラメーターはサポートされていませんし、utf-8 エンコーディングが常に有効です。
@@ -112,28 +173,29 @@ SD カードが利用できない場合、以前のバージョン取得デー
IOS デバイスに永続的なファイルを格納する 2 つの有効な場所がある: ドキュメントとライブラリのディレクトリ。 プラグインの以前のバージョンは、唯一のこれまでドキュメント ディレクトリに永続的なファイルを格納されます。 これは、ディレクトリの目的は、輸出のための完全なドキュメントを作成するのではなくなかったがしばしば意図されていたり、特に多数の小さいファイルを処理するアプリケーションの場合、iTunes に表示されているすべてのアプリケーションのファイルを作るの副作用があった。
-ドキュメントまたはアプリケーションの config.xml ファイルに優先順位のライブラリ ディレクトリにファイルを保存するかどうかを選択することが可能です今。 これを行うに、config.xml に次の 2 行のいずれかを追加します。
+ドキュメントまたはアプリケーションの優先順位のライブラリ ディレクトリにファイルを保存するかどうかを選択することは今 `config.xml` ファイル。 これを行うに、追加する次の 2 行のいずれか `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-この行がなければファイル プラグインは既定値として「互換性」を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
+この行がなければファイルのプラグインが使用する `Compatibility` 、デフォルトとして。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
-アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには「互換性」を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを以前に保存されたファイルにアクセスすることができるだろうことを意味する「ライブラリ」に場所をスイッチングします。
+アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用してこのプラグインのバージョンは、永続的なファイルシステムに保存されているファイルしに優先順位を設定する必要があります `Compatibility` 。 スイッチングする場所 `Library` は自分のアプリケーションをアップグレードする既存のユーザーを以前に保存されたファイルにアクセスすることができるだろうことを意味します。
-アプリケーション場合は、新しい、または永続的なファイルシステムにファイルが格納され以前は決して、「ライブラリ」設定は推奨一般に。
+場合は、アプリケーションが新しい、または永続的なファイルシステムにファイルが格納され決して以前し、 `Library` の設定は一般にお勧めします。
-### Firefox OS 癖
+## Firefox OS 癖
ファイル システム API Firefox OS でネイティブ サポートされていないと、indexedDB の上にシムとして実装されています。
* 空でないディレクトリを削除するときに失敗しません
* ディレクトリのメタデータをサポートしていません
-* サポートしていない `requestAllFileSystems` と `resolveLocalFileSystemURI` 方法
* 方法 `copyTo` と `moveTo` ディレクトリをサポートしていません
+次のデータ パスがサポートされています： * `applicationDirectory` -を使用して `xhr` アプリケーションと共にパッケージ化されるローカル ファイルを取得します。 * `dataDirectory` - 永続的なアプリケーション固有のデータ ファイル。 * `cacheDirectory` -キャッシュされたアプリの再起動後も維持する必要がありますファイル (アプリはここにファイルを削除する OS に依存しないでください)。
+
## ノートをアップグレードします。
このプラグインのデベロッパーで、 `FileEntry` と `DirectoryEntry` 構造変更、公開された仕様に沿ったより多くであります。
@@ -153,7 +215,7 @@ IOS デバイスに永続的なファイルを格納する 2 つの有効な場
場合は、アプリケーションはデバイス絶対パスで動作し、以前からそれらのパスを取得、 `fullPath` のプロパティ `Entry` を使用してコードを更新する必要があり、オブジェクト `entry.toURL()` 代わりに。
-後方の互換性、 `resolveLocalFileSystemURL()` メソッドはデバイス絶対パスを受け入れるし、戻ります、 `Entry` 、一時的または永続的なファイル ・ システム内でそのファイルが存在する限り、それに対応するオブジェクト。
+後方互換性、 `resolveLocalFileSystemURL()` メソッドはデバイス絶対パスを受け入れるし、戻ります、 `Entry` オブジェクトのいずれかの内でそのファイルが存在する限り、それに対応する、 `TEMPORARY` または `PERSISTENT` ファイルシステム。
これは特に以前デバイス絶対パスを使用してファイル転送のプラグインで問題となっている （そしてまだそれらを受け入れることができます）。 ので交換、ファイルシステムの Url で正しく動作するように更新されている `entry.fullPath` と `entry.toURL()` デバイス上のファイルで動作するプラグインを得て問題を解決する必要があります。
@@ -168,18 +230,20 @@ V1.1.0 戻り値での `toURL()` が変更された (\[CB-6394\] (https://issues
エラーがスローされると、次のコードのいずれかが使用されます。
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| コード | 定数 |
+| ---:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## (省略可能) プラグインを構成します。
@@ -191,21 +255,21 @@ V1.1.0 戻り値での `toURL()` が変更された (\[CB-6394\] (https://issues
### アンドロイド
-* ファイル： アプリケーションの内部ファイルのストレージ ディレクトリ
-* 外部ファイル: アプリケーションの外部のファイルのストレージ ディレクトリ
-* sd カード：、グローバル外部ストレージ ディレクトリをファイル (これは SD カードのルートがインストールされている場合)。 必要があります、 `android.permission.WRITE_EXTERNAL_STORAGE` これを使用するアクセス許可。
-* キャッシュ： アプリケーションの内部キャッシュ ディレクトリ
-* キャッシュ外部： 外部キャッシュのアプリケーションのディレクトリ
-* ルート： デバイス全体のファイルシステム
+* `files`: アプリケーション内部のファイル ・ ストレージ ・ ディレクトリ
+* `files-external`: アプリケーションの外部のファイルのストレージ ディレクトリ
+* `sdcard`: グローバル外部ファイル ストレージ ディレクトリ (これは SD カードのルートがインストールされている場合)。 必要があります、 `android.permission.WRITE_EXTERNAL_STORAGE` これを使用するアクセス許可。
+* `cache`: アプリケーションの内部キャッシュ ディレクトリ
+* `cache-external`: アプリケーション ディレクトリ外部キャッシュ
+* `root`： デバイス全体のファイルシステム
アンドロイドを「ファイル」ファイルシステム内の"ドキュメント/"サブディレクトリを表す"ドキュメント"という名前の特殊なファイルシステムもサポートしています。
### iOS
-* ライブラリ: ライブラリのアプリケーションのディレクトリ
-* ドキュメント: ドキュメントのアプリケーションのディレクトリ
-* キャッシュ: キャッシュのアプリケーションのディレクトリ
-* バンドル: アプリケーションバンドル;アプリ自体 (読み取りのみ) ディスク上の場所
-* ルート： デバイス全体のファイルシステム
+* `library`: アプリケーションのライブラリ ディレクトリ
+* `documents`: アプリケーションの Documents ディレクトリ
+* `cache`: アプリケーションのキャッシュ ディレクトリ
+* `bundle`: アプリケーションのバンドル。アプリ自体 (読み取りのみ) ディスク上の場所
+* `root`： デバイス全体のファイルシステム
-既定では、ライブラリとドキュメント ディレクトリを iCloud に同期できます。 ライブラリまたはドキュメントのファイルシステム内の特別な非同期ディレクトリを表す 2 つの追加のファイルシステム、"ライブラリ nosync"、「ドキュメント nosync」を要求することもできます。
\ No newline at end of file
+既定では、ライブラリとドキュメント ディレクトリを iCloud に同期できます。 2 つの追加のファイルシステムを要求することもできます `library-nosync` と `documents-nosync` 、内の特別な非同期ディレクトリを表す、 `/Library` または `/Documents` ファイルシステム。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
index 1a976dd..a9ca452 100644
--- a/doc/ko/index.md
+++ b/doc/ko/index.md
@@ -56,27 +56,87 @@
V1.2.0, 현재 중요 한 파일 시스템 디렉터리에 Url도 제공 됩니다. 각 URL 형태 *file:///path/to/spot/*이며 변환할 수는 `DirectoryEntry` 를 사용 하 여`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-읽기 전용 디렉터리는 응용 프로그램을 설치 합니다. (*iOS*, *안 드 로이드*)
+* `cordova.file.applicationDirectory`-읽기 전용 디렉터리는 응용 프로그램을 설치 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)
-`cordova.file.applicationStorageDirectory`-애플 리 케이 션의 개인 쓰기 가능한 저장소의 루트입니다. (*iOS*, *안 드 로이드*)
+* `cordova.file.applicationStorageDirectory`응용 프로그램의 샌드박스;의 루트 디렉터리 iOS에이 위치에는 읽기 전용 (특정 하위 디렉토리만 [같은 `/Documents` ]은 읽기 / 쓰기). 포함 된 모든 데이터는 응용 프로그램에 전용. ( *iOS*, *안 드 로이드*, *블랙베리 10*)
-`cordova.file.dataDirectory`-응용 프로그램-특정 데이터 파일을 넣어 어디. (*iOS*, *안 드 로이드*)
+* `cordova.file.dataDirectory`-내부 메모리를 사용 하 여 응용 프로그램의 샌드박스 내에서 영구 및 개인 데이터 스토리지 (안 드 로이드, 외부 메모리를 사용 해야 하는 경우 사용 하 여 `.externalDataDirectory` ). IOS에이 디렉터리 iCloud와 동기화 되지 되 (를 사용 하 여 `.syncedDataDirectory` ). (*iOS*, *안 드 로이드*, *블랙베리 10*)
-`cordova.file.cacheDirectory`-캐시 응용 프로그램 다시 시작 해야 하는 파일. 애플 리 케이 션은 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야. (*iOS*, *안 드 로이드*)
+* `cordova.file.cacheDirectory`-디렉터리 캐시 데이터 파일 또는 모든 파일을 당신의 app를 다시 쉽게 만들 수 있습니다. 운영 체제 장치 저장소 부족 하면 이러한 파일을 삭제할 수 있습니다, 그리고 그럼에도 불구 하 고, 애플 리 케이 션 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)
-`cordova.file.externalApplicationStorageDirectory`-응용 프로그램 외부 저장 공간입니다. (*iOS*, *안 드 로이드*)
+* `cordova.file.externalApplicationStorageDirectory`-응용 프로그램 외부 저장 공간입니다. (*안 드 로이드*)
-`cordova.file.externalDataDirectory`-외부 저장소에 응용 프로그램 특정 데이터 파일을 넣어 어디. (*안 드 로이드*)
+* `cordova.file.externalDataDirectory`-외부 저장소에 응용 프로그램 특정 데이터 파일을 넣어 어디. (*안 드 로이드*)
-`cordova.file.externalCacheDirectory`외부 저장소에 응용 프로그램 캐시입니다. (*안 드 로이드*)
+* `cordova.file.externalCacheDirectory`외부 저장소에 응용 프로그램 캐시입니다. (*안 드 로이드*)
-`cordova.file.externalRootDirectory`-외부 저장 (SD 카드) 루트입니다. (*안 드 로이드*)
+* `cordova.file.externalRootDirectory`-외부 저장 (SD 카드) 루트입니다. (*안 드 로이드*, *블랙베리 10*)
-`cordova.file.tempDirectory`-운영 체제에서 지울 수 있습니다 임시 디렉터리 것입니다. (*iOS*)
+* `cordova.file.tempDirectory`-운영 체제에서 지울 수 있습니다 임시 디렉터리 것입니다. 이 디렉터리;를 운영 체제에 의존 하지 마십시오 귀하의 응용 프로그램 항상 해당 하는 경우 파일을 제거 해야 합니다. (*iOS*)
-`cordova.file.syncedDataDirectory`-(ICloud)를 예를 들어 동기화 해야 하는 응용 프로그램 관련 파일을 보유 하 고 있습니다. (*iOS*)
+* `cordova.file.syncedDataDirectory`-(ICloud)를 예를 들어 동기화 해야 하는 응용 프로그램 관련 파일을 보유 하 고 있습니다. (*iOS*)
-`cordova.file.documentsDirectory`-애플 리 케이 션, 하지만 그 개인 파일은 다른 applciations (예를 들어 Office 파일)을 의미. (*iOS*)
+* `cordova.file.documentsDirectory`-파일 애플 리 케이 션, 하지만 그 개인은 다른 응용 프로그램 (예: Office 파일)에 의미입니다. (*iOS*)
+
+* `cordova.file.sharedDirectory`-모든 응용 프로그램 (*블랙베리 10* 에 전세계적으로 사용 가능한 파일)
+
+## 파일 시스템 레이아웃
+
+비록 기술적으로 구현 세부 사항, 그것은 매우 유용할 수 있습니다 알고 어떻게 `cordova.file.*` 실제 장치에 실제 경로를 속성 지도.
+
+### iOS 파일 시스템 레이아웃
+
+| 장치 경로 | `cordova.file.*` | `iosExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 동기화 | 개인 |
+|:------------------------------------ |:--------------------------- |:--------------------- |:----:|:------:|:---------:|:---:|:--:|
+| `/ var/모바일/응용 프로그램/< UUID > /` | applicationStorageDirectory | - | r/o | N/A | N/A | N/A | 예 |
+| `appname.app/` | applicationDirectory | 번들 | r/o | N/A | N/A | N/A | 예 |
+| `www/` | - | - | r/o | N/A | N/A | N/A | 예 |
+| `Documents/` | documentsDirectory | 문서 | r/w | 예 | 없음 | 예 | 예 |
+| `NoCloud/` | - | 문서 nosync | r/w | 예 | 없음 | 없음 | 예 |
+| `Library` | - | 라이브러리 | r/w | 예 | 없음 | 그래? | 예 |
+| `NoCloud/` | dataDirectory | 라이브러리 nosync | r/w | 예 | 없음 | 없음 | 예 |
+| `Cloud/` | syncedDataDirectory | - | r/w | 예 | 없음 | 예 | 예 |
+| `Caches/` | cacheDirectory | 캐시 | r/w | 예 * | 예 \* * *| | 없음 | 예 |
+| `tmp/` | tempDirectory | - | r/w | 아니 * * | 예 \* * *| | 없음 | 예 |
+
+* 파일 응용 프로그램 다시 시작 및 업그레이드, 유지 하지만 OS 욕망 언제 든 지이 디렉터리를 지울 수 있습니다. 앱 삭제 될 수 있습니다 모든 콘텐츠를 다시 만들 수 있어야 합니다.
+
+* * 파일 응용 프로그램 다시 시작에서 지속 될 수 있습니다 하지만이 동작에 의존 하지 마십시오. 파일 여러 업데이트를 보장 하지 않습니다. 때 해당 앱이이 디렉터리에서 파일을 제거 해야, 이러한 파일을 제거할 때 (또는 경우에도) 운영 체제 보증 하지 않습니다으로.
+
+\* * *| OS 그것이 필요를 느낀다 언제 든 지이 디렉터리의 내용을 취소 될 수 있습니다 하지만 이것에 의존 하지 마십시오. 이 디렉터리를 응용 프로그램에 대 한 적절 한 선택을 취소 해야 합니다.
+
+### 안 드 로이드 파일 시스템 레이아웃
+
+| 장치 경로 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 개인 |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:---:|:-------:|:--:|
+| `file:///android_asset/` | applicationDirectory | | r/o | N/A | N/A | 예 |
+| `/data/데이터/< app id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | 예 |
+| `cache` | cacheDirectory | 캐시 | r/w | 예 | 예 * | 예 |
+| `files` | dataDirectory | 파일 | r/w | 예 | 없음 | 예 |
+| `Documents` | | 문서 | r/w | 예 | 없음 | 예 |
+| `< sdcard > /` | externalRootDirectory | sdcard | r/w | 예 | 없음 | 없음 |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | 예 | 없음 | 없음 |
+| `cache` | externalCacheDirectry | 외부 캐시 | r/w | 예 | 아니 * * | 없음 |
+| `files` | externalDataDirectory | 파일 외부 | r/w | 예 | 없음 | 없음 |
+
+* OS 수 있습니다 정기적으로이 디렉터리에 있지만이 동작에 의존 하지 마십시오. 이 응용 프로그램이 디렉터리의 내용을 취소 합니다. 사용자 수동으로 캐시 제거 해야,이 디렉터리의 내용은 제거 됩니다.
+
+* * OS 지워지지 않습니다이 디렉터리 자동으로; 콘텐츠를 관리 하기 위한 책임이 있습니다. 사용자 수동으로 캐시 제거 합니다, 디렉터리의 내용은 제거 됩니다.
+
+**참고**: 외부 저장소를 탑재할 수 없는 경우는 `cordova.file.external*` 속성은`null`.
+
+### 블랙베리 10 파일 시스템 레이아웃
+
+| 장치 경로 | `cordova.file.*` | r/w? | 영구? | OS 지웁니다 | 개인 |
+|:--------------------------------------------------- |:--------------------------- |:----:|:---:|:-------:|:--:|
+| `file:///accounts/1000/appdata/ < app id > /` | applicationStorageDirectory | r/o | N/A | N/A | 예 |
+| `app/native` | applicationDirectory | r/o | N/A | N/A | 예 |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 없음 | 예 | 예 |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 예 | 없음 | 예 |
+| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 예 | 없음 | 없음 |
+| `file:///accounts/1000/shared` | sharedDirectory | r/w | 예 | 없음 | 없음 |
+
+*참고*: 모든 경로 /accounts/1000-enterprise를 기준으로 응용 프로그램 경계를 작동 하도록 배포 될 때.
## 안 드 로이드 단점
@@ -88,23 +148,24 @@ V1.2.0, 현재 중요 한 파일 시스템 디렉터리에 Url도 제공 됩니
플러그인의 이전 버전을 시작할 때, 장치는 SD 카드 (또는 해당 스토리지 파티션) 탑재 했다 주장 하는 여부에 따라 임시 및 영구 파일의 위치를 선택 합니다. SD 카드 마운트, 또는 큰 내부 스토리지 파티션에 사용할 수 있었습니다 (같은 넥서스 장치에) 그 후에 영구 파일 공간의 루트에 저장 됩니다. 이 모든 코르 도우 바 애플 리 케이 션 카드에 모두 사용할 수 있는 파일을 볼 수 있는 의미 합니다.
-SD 카드 사용할 수 있었다면, 이전 버전에서 /data/데이터/데이터 저장 것이<packageid>서로 다른 애플 리 케이 션을 분리 하지만 사용자 간에 공유할 데이터를 일으킬 수 있습니다.
+SD 카드는 사용할 수 있는 경우 이전 버전에서 데이터 저장 `/data/data/<packageId>` 는 서로 다른 애플 리 케이 션을 분리 하지만 여전히 원인 데이터를 사용자 간에 공유할 수 있습니다.
-그것은 지금 내부 파일 저장 위치 또는 응용 프로그램의 config.xml 파일에 기본 설정으로 이전 논리를 사용 하 여 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 config.xml에이 두 줄 중 하나를 추가:
+내부 파일 저장 위치 또는 응용 프로그램에서 기본 설정으로 이전 논리를 사용 하 여 파일을 저장할 것인지를 선택할 수 `config.xml` 파일. 이렇게 하려면 다음 두 줄을 중 하나를 추가 `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-이 줄이 없으면 파일 플러그인은 기본적으로 "호환성"을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.
+파일 플러그인 사용이 줄이 없으면 `Compatibility` 는 기본적으로. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.
-이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일에는 다음 "호환성" 특혜를 설정 해야 합니다. "내부"의 위치 전환 그들의 응용 프로그램을 업그레이드 기존 사용자의 그들의 장치에 따라 그들의 이전에 저장 된 파일에 액세스할 수 수 있다는 뜻입니다.
+이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 다음 환경 설정을 설정 해야 및 `Compatibility` . "내부"의 위치 전환 그들의 응용 프로그램을 업그레이드 기존 사용자의 그들의 장치에 따라 그들의 이전에 저장 된 파일에 액세스할 수 수 있다는 뜻입니다.
-경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에서 파일 저장, "내부" 설정은 일반적으로 권장 됩니다.
+응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장 하는 경우는 `Internal` 일반적으로 권장 됩니다.
## iOS 단점
+* `cordova.file.applicationStorageDirectory`읽기 전용; 루트 디렉터리 내에서 파일을 저장 하려고에 실패 합니다. 다른 중 하나를 사용 하 여 `cordova.file.*` iOS에 대해 정의 된 속성 (만 `applicationDirectory` 와 `applicationStorageDirectory` 는 읽기 전용).
* `FileReader.readAsText(blob, encoding)`
* `encoding`매개 변수는 지원 되지 않습니다, 및 효과에 항상 u t F-8 인코딩을 합니다.
@@ -112,28 +173,29 @@ SD 카드 사용할 수 있었다면, 이전 버전에서 /data/데이터/데이
IOS 디바이스에 영구 파일을 저장할 두 개의 유효한 위치가 있다: 문서 디렉터리 및 라이브러리 디렉터리. 플러그인의 이전 버전은 오직 문서 디렉토리에 영구 파일을 저장. 이 부작용 보다는 아니었다 수시로 특히 많은 작은 파일을 처리 하는 응용 프로그램에 대 한 의도, iTunes에 표시 모든 응용 프로그램 파일을 만드는 디렉터리의 용도 내보내기에 대 한 완전 한 문서를 생산 했다.
-그것은 지금 문서 또는 응용 프로그램의 config.xml 파일에 기본 설정으로 라이브러리 디렉토리에 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 config.xml에이 두 줄 중 하나를 추가:
+문서 또는 응용 프로그램에서 기본 설정으로 라이브러리 디렉토리에 파일을 저장할 것인지를 선택할 수 `config.xml` 파일. 이렇게 하려면 다음 두 줄을 중 하나를 추가 `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-이 줄이 없으면 파일 플러그인은 기본적으로 "호환성"을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.
+파일 플러그인 사용이 줄이 없으면 `Compatibility` 는 기본적으로. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.
-이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일에는 다음 "호환성" 특혜를 설정 해야 합니다. "라이브러리" 위치 전환 기존 사용자에 게 응용 프로그램을 업그레이 드의 그들의 이전에 저장 된 파일에 액세스할 수 것을 의미할 것입니다.
+이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 다음 환경 설정을 설정 해야 및 `Compatibility` . 위치를 스위칭 `Library` 기존 사용자에 게 응용 프로그램을 업그레이 드의 그들의 이전에 저장 된 파일에 액세스할 수 것을 의미할 것입니다.
-경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에서 파일 저장, "도서관" 설정은 일반적으로 권장 됩니다.
+응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장 하는 경우는 `Library` 일반적으로 권장 됩니다.
-### 파이어 폭스 OS 단점
+## 파이어 폭스 OS 단점
파일 시스템 API Firefox 운영 체제에서 기본적으로 지원 하지 및 indexedDB 위에 심으로 구현 됩니다.
* 비어 있지 않은 디렉터리를 제거할 때 실패 하지 않습니다.
* 디렉터리에 대 한 메타 데이터를 지원 하지 않습니다.
-* 지원 하지 않는 `requestAllFileSystems` 및 `resolveLocalFileSystemURI` 메서드
* 메서드 `copyTo` 및 `moveTo` 디렉터리를 지원 하지 않습니다
+다음 데이터 경로 지원 됩니다: * `applicationDirectory` -를 사용 하 여 `xhr` 응용 프로그램으로 패키지 된 로컬 파일을. * `dataDirectory` -영구 응용 프로그램 특정 데이터 파일에 대 한. * `cacheDirectory` -캐시 응용 프로그램 다시 시작 해야 하는 파일 (애플 리 케이 션은 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야).
+
## 업그레이드 노트
이 플러그인의 v1.0.0에는 `FileEntry` 와 `DirectoryEntry` 구조 변경, 게시 된 사양에 맞춰 더 많은 것.
@@ -153,7 +215,7 @@ V1.0.0와 `fullPath` 특성은 *HTML 파일 시스템의 루트에 상대적인*
장치 절대 경로, 응용 프로그램 작동 하 고 이전을 통해 그 경로 검색 하는 경우는 `fullPath` 속성의 `Entry` 개체를 사용 하 여 코드를 업데이트 해야 하는 다음 `entry.toURL()` 대신.
-대 한 뒤 호환성는 `resolveLocalFileSystemURL()` 장치-절대-경로, 수락할 메서드와 반환 합니다는 `Entry` 파일을 임시 또는 영구 파일 시스템 내에서 존재 하는 경우, 해당 개체.
+대 한 뒤 호환성는 `resolveLocalFileSystemURL()` 장치-절대-경로, 수락할 메서드와 반환 합니다는 `Entry` 파일 중 하나에 내 존재 하는 경우, 해당 개체는 `TEMPORARY` 또는 `PERSISTENT` 파일 시스템.
이 특히 이전 장치 절대 경로 사용 하는 파일 전송 플러그인에 문제가 있다 (그리고 아직도 그들을 받아들일 수.) 파일 시스템 Url, 그래서 대체 올바르게 작동 하도록 업데이 트 되었습니다 `entry.fullPath` 함께 `entry.toURL()` 장치에 파일을 사용 하는 플러그인을 지 고 문제를 해결 해야 합니다.
@@ -168,18 +230,20 @@ V1.1.0 반환 값에서에서의 `toURL()` 변경 되었습니다 (\[CB-6394\] (
오류가 throw 됩니다 때 다음 코드 중 하나가 사용 됩니다.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| 코드 | 상수 |
+| --:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## (선택 사항) 플러그인 구성
@@ -191,21 +255,21 @@ V1.1.0 반환 값에서에서의 `toURL()` 변경 되었습니다 (\[CB-6394\] (
### 안 드 로이드
-* 파일: 응용 프로그램의 내부 파일 저장 디렉토리
-* 파일 외부: 응용 프로그램의 외부 파일 저장 디렉토리
-* sdcard: 글로벌 외부 파일 저장 디렉토리 (이것은 SD 카드의 루트 설치 된 경우). 가지고 있어야 합니다는 `android.permission.WRITE_EXTERNAL_STORAGE` 이 사용 하는 허가.
-* 캐시: 응용 프로그램의 내부 캐시 디렉터리
-* 캐시 외부: 응용 프로그램의 외부 캐시 디렉터리
-* 루트: 전체 장치 파일 시스템
+* `files`: 응용 프로그램의 내부 파일 저장 디렉토리
+* `files-external`: 응용 프로그램의 외부 파일 저장 디렉토리
+* `sdcard`: 글로벌 외부 파일 저장 디렉토리 (이것은 SD 카드의 루트 설치 된 경우). 가지고 있어야 합니다는 `android.permission.WRITE_EXTERNAL_STORAGE` 이 사용 하는 허가.
+* `cache`: 응용 프로그램의 내부 캐시 디렉터리
+* `cache-external`: 응용 프로그램의 외부 캐시 디렉터리
+* `root`: 전체 장치 파일 시스템
안 드 로이드는 또한 "파일" 파일 시스템 내에서 "/ 문서 /" 하위 디렉토리를 나타내는 "문서" 라는 특별 한 파일을 지원 합니다.
### iOS
-* 라이브러리: 응용 프로그램의 라이브러리 디렉터리
-* 문서: 응용 프로그램의 문서 디렉토리
-* 캐시: 응용 프로그램의 캐시 디렉터리
-* 번들: 응용 프로그램의 번들; (읽기 전용) 디스크에 응용 프로그램 자체의 위치
-* 루트: 전체 장치 파일 시스템
+* `library`: 응용 프로그램의 라이브러리 디렉터리
+* `documents`: 응용 프로그램의 문서 디렉토리
+* `cache`: 응용 프로그램의 캐시 디렉터리
+* `bundle`: 응용 프로그램의 번들; (읽기 전용) 디스크에 응용 프로그램 자체의 위치
+* `root`: 전체 장치 파일 시스템
-기본적으로 라이브러리 및 문서 디렉토리 iCloud에 동기화 할 수 있습니다. 2 개의 추가적인 파일 시스템, "도서관 nosync" 및 "문서 nosync" 라이브러리 또는 문서 파일 시스템 내에서 특별 한 비 동기화 디렉터리를 대표 하는 요청할 수 있습니다.
\ No newline at end of file
+기본적으로 라이브러리 및 문서 디렉토리 iCloud에 동기화 할 수 있습니다. 또한 2 개의 추가적인 파일 시스템을 요청할 수 있습니다 `library-nosync` 과 `documents-nosync` , 어떤 특별 한 비 동기화 디렉터리 내에서 대표는 `/Library` 또는 `/Documents` 파일 시스템.
\ No newline at end of file
[3/3] git commit: CB-7249cordova-plugin-file documentation
translation: cordova-plugin-file
Posted by ld...@apache.org.
CB-7249cordova-plugin-file documentation translation: cordova-plugin-file
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/commit/fa64fa54
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/tree/fa64fa54
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/diff/fa64fa54
Branch: refs/heads/master
Commit: fa64fa54ca953e45c10f559659833eadf34b48b8
Parents: 8913257
Author: Lisa Seacat DeLuca <ld...@us.ibm.com>
Authored: Fri Aug 1 16:23:36 2014 -0400
Committer: Lisa Seacat DeLuca <ld...@us.ibm.com>
Committed: Fri Aug 1 16:23:36 2014 -0400
----------------------------------------------------------------------
doc/de/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/es/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/fr/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/it/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/ja/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/ko/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/pl/index.md | 182 ++++++++++++++++++++++++++++++++++++---------------
doc/ru/index.md | 158 +++++++++++++++++++++++++++++++-------------
doc/zh/index.md | 168 ++++++++++++++++++++++++++++++++---------------
9 files changed, 1021 insertions(+), 435 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/de/index.md
----------------------------------------------------------------------
diff --git a/doc/de/index.md b/doc/de/index.md
index e7c21f7..84153b4 100644
--- a/doc/de/index.md
+++ b/doc/de/index.md
@@ -56,27 +56,87 @@ Finden Sie einen Überblick über andere Speicheroptionen Cordovas [Speicher-Fü
Stand: V1 werden URLs auf wichtige Datei-System-Verzeichnisse zur Verfügung gestellt. Jede URL in der Form *file:///path/to/spot/*ist, und konvertiert werden können eine `DirectoryEntry` mit`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Die schreibgeschützten Verzeichnis, in dem die Anwendung installiert ist. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Die schreibgeschützten Verzeichnis, in dem die Anwendung installiert ist. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.applicationStorageDirectory`-Stamm der app's private beschreibbaren Speicher. (*iOS*, *Android*)
+* `cordova.file.applicationStorageDirectory`-Root-Verzeichnis der Anwendungs-Sandbox; auf iOS ist schreibgeschützt (aber bestimmte Unterverzeichnisse [wie `/Documents` ] sind Lese-und Schreibzugriff). Alle enthaltene Daten ist für die app privat. ( *iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.dataDirectory`-Wo app-spezifische Datendateien zu setzen. (*iOS*, *Android*)
+* `cordova.file.dataDirectory`-Beständige und private Datenspeicherung innerhalb der Anwendungs-Sandbox, die mit internen Speicher (auf Android, externen Speicher verwenden, verwenden Sie `.externalDataDirectory` ). Auf iOS, ist dieses Verzeichnis nicht mit iCloud synchronisiert (verwenden Sie `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-Cache-Dateien, die app startet überleben sollte. Apps sollten nicht vom Betriebssystem zum Löschen von Dateien hier verlassen. (*iOS*, *Android*)
+* `cordova.file.cacheDirectory`-Verzeichnis der zwischengespeicherten Daten-Dateien oder Dateien, die Ihre app einfach neu erstellen können. Das Betriebssystem kann diese Dateien löschen, wenn das Gerät auf Speicher knapp wird, dennoch sollten die apps vom Betriebssystem zum Löschen von Dateien hier nicht verlassen. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.externalApplicationStorageDirectory`-Anwendungsraum auf externen Speicher. (*iOS*, *Android*)
+* `cordova.file.externalApplicationStorageDirectory`-Anwendungsraum auf externen Speicher. (*Android*)
-`cordova.file.externalDataDirectory`-Wo, app-spezifische Datendateien auf externen Speicher setzen. (*Android*)
+* `cordova.file.externalDataDirectory`-Wo, app-spezifische Datendateien auf externen Speicher setzen. (*Android*)
-`cordova.file.externalCacheDirectory`-Anwendungscache auf externen Speicher. (*Android*)
+* `cordova.file.externalCacheDirectory`-Anwendungscache auf externen Speicher. (*Android*)
-`cordova.file.externalRootDirectory`-Externer Speicher (SD-Karte) Stamm. (*Android*)
+* `cordova.file.externalRootDirectory`-Externer Speicher (SD-Karte) Stamm. (*Android*, *BlackBerry 10*)
-`cordova.file.tempDirectory`-Temp-Verzeichnis, dem das OS auf deaktivieren können wird. (*iOS*)
+* `cordova.file.tempDirectory`-Temp-Verzeichnis, dem das OS auf deaktivieren können wird. Verlassen Sie sich nicht auf das Betriebssystem, um dieses Verzeichnis zu löschen; Ihre Anwendung sollte immer Dateien gegebenenfalls entfernen. (*iOS*)
-`cordova.file.syncedDataDirectory`-Hält app-spezifische Dateien, die (z. B. auf iCloud) synchronisiert werden sollten. (*iOS*)
+* `cordova.file.syncedDataDirectory`-Hält app-spezifische Dateien, die (z. B. auf iCloud) synchronisiert werden sollten. (*iOS*)
-`cordova.file.documentsDirectory`-Dateien für die app, aber privat sind sinnvoll, andere Anwendungen (z.B. Office-Dateien). (*iOS*)
+* `cordova.file.documentsDirectory`-Dateien für die app, aber privat sind sinnvoll, andere Anwendungen (z.B. Office-Dateien). (*iOS*)
+
+* `cordova.file.sharedDirectory`-Dateien für alle Anwendungen (*BlackBerry 10* weltweit verfügbar)
+
+## Dateisystemlayouts
+
+Obwohl technisch ein Implementierungsdetail, kann es sehr hilfreich zu wissen wie die `cordova.file.*` Eigenschaften anzeigen auf physischen Pfade auf einem echten Gerät.
+
+### iOS-Datei-System-Layout
+
+| Gerätepfad | `Cordova.file.*` | `iosExtraFileSystems` | R/w? | persistent? | OS löscht | Sync | Private |
+|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:-----------:|:----------:|:----:|:-------:|
+| `/ Var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | R/o | N/A | N/A | N/A | Ja |
+| `appname.app/` | applicationDirectory | Bundle | R/o | N/A | N/A | N/A | Ja |
+| `www/` | - | - | R/o | N/A | N/A | N/A | Ja |
+| `Documents/` | documentsDirectory | Dokumente | R/w | Ja | Nein | Ja | Ja |
+| `NoCloud/` | - | Dokumente-nosync | R/w | Ja | Nein | Nein | Ja |
+| `Library` | - | Bibliothek | R/w | Ja | Nein | Ja? | Ja |
+| `NoCloud/` | dataDirectory | Bibliothek-nosync | R/w | Ja | Nein | Nein | Ja |
+| `Cloud/` | syncedDataDirectory | - | R/w | Ja | Nein | Ja | Ja |
+| `Caches/` | cacheDirectory | Cache | R/w | Ja * | Ja \* * *| | Nein | Ja |
+| `tmp/` | tempDirectory | - | R/w | Nicht * * | Ja \* * *| | Nein | Ja |
+
+* Dateien werden hinweg app Neustarts und Upgrades beibehalten, aber dieses Verzeichnis kann gelöscht werden, wenn das OS begehrt. Ihre Anwendung sollte in der Lage, Inhalte zu erschaffen, die möglicherweise gelöscht werden.
+
+* *-Dateien kann über app-Neustarts beizubehalten, aber verlasse dich nicht auf dieses Verhalten. Dateien sind nicht unbedingt Aktuelles beibehalten. Ihre Anwendung sollte Dateien aus diesem Verzeichnis entfernen, wenn es gilt, diese Dateien werden entfernt, da das OS nicht wann (oder auch wenn) garantiert.
+
+\* * *| The OS kann den Inhalt dieses Verzeichnisses löschen, wenn es sich anfühlt, ist es erforderlich, aber verlassen Sie sich nicht dazu. Sie sollten dieses Verzeichnis entsprechend Ihrer Anwendung deaktivieren.
+
+### Android File System-Layout
+
+| Gerätepfad | `Cordova.file.*` | `AndroidExtraFileSystems` | R/w? | persistent? | OS löscht | Private |
+|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:-----------:|:---------:|:-------:|
+| `file:///android_asset/` | applicationDirectory | | R/o | N/A | N/A | Ja |
+| `/ Data/Data/< app-Id > /` | applicationStorageDirectory | - | R/w | N/A | N/A | Ja |
+| `cache` | cacheDirectory | Cache | R/w | Ja | Ja * | Ja |
+| `files` | dataDirectory | Dateien | R/w | Ja | Nein | Ja |
+| `Documents` | | Dokumente | R/w | Ja | Nein | Ja |
+| `< Sdcard > /` | externalRootDirectory | sdcard | R/w | Ja | Nein | Nein |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | R/w | Ja | Nein | Nein |
+| `cache` | externalCacheDirectry | Cache-extern | R/w | Ja | Nicht * * | Nein |
+| `files` | externalDataDirectory | Dateien-extern | R/w | Ja | Nein | Nein |
+
+* Das Betriebssystem kann regelmäßig dieses Verzeichnis zu löschen, aber verlasse dich nicht auf dieses Verhalten. Deaktivieren Sie den Inhalt dieses Verzeichnisses für Ihre Anwendung geeigneten. Ein Benutzer den Cache manuell löschen sollte, werden die Inhalte dieses Verzeichnisses entfernt.
+
+* * The OS nicht klar dieses Verzeichnis automatisch; Sie sind verantwortlich für die Inhalte selbst verwalten. Der Benutzer den Cache manuell löschen sollte, werden der Inhalt des Verzeichnisses entfernt.
+
+**Hinweis**: Wenn externe Speichergeräte nicht bereitgestellt werden kann, die `cordova.file.external*` Eigenschaften sind`null`.
+
+### BlackBerry 10-File-System-Layout
+
+| Gerätepfad | `Cordova.file.*` | R/w? | persistent? | OS löscht | Private |
+|:--------------------------------------------------- |:--------------------------- |:----:|:-----------:|:---------:|:-------:|
+| `file:///Accounts/1000/APPDATA/ < app Id > /` | applicationStorageDirectory | R/o | N/A | N/A | Ja |
+| `app/native` | applicationDirectory | R/o | N/A | N/A | Ja |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | R/w | Nein | Ja | Ja |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | R/w | Ja | Nein | Ja |
+| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | R/w | Ja | Nein | Nein |
+| `file:///Accounts/1000/Shared` | sharedDirectory | R/w | Ja | Nein | Nein |
+
+*Hinweis*: Wenn die Anwendung bereitgestellt wird, um Perimeter zu arbeiten, alle Pfade sind relativ /accounts/1000-enterprise.
## Android Macken
@@ -88,23 +148,24 @@ Es gibt mehrere gültige Speicherorte, persistente Dateien auf einem Android-Ger
Frühere Versionen des Plugins wählen würde, den Speicherort der temporären und permanenten Dateien beim Start, basierend auf, ob das Gerät behauptete, dass die SD-Karte (oder gleichwertige Speicherpartition) bereitgestellt wurde. Wenn die SD-Karte eingelegt wurde, oder wenn eine große interne Speicherpartition verfügbar war (wie auf Nexus-Geräten) und dann in die Wurzel dieses Raumes, die persistenten Dateien gespeichert werden. Dies bedeutete, dass alle Cordova apps aller verfügbaren Dateien auf der Karte sehen konnte.
-Wenn die SD-Karte nicht verfügbar war, würde dann frühere Versionen unter/Data/Data/Datenspeicher<packageid>, die apps von einander isoliert, kann aber noch Daten für Benutzer freigegeben werden.
+Wenn die SD-Karte nicht verfügbar war, dann Vorgängerversionen Daten unter speichern würde `/data/data/<packageId>` , die isoliert Anwendungen voneinander, aber möglicherweise noch Ursache Daten zwischen Benutzern freigegeben werden.
-Es ist jetzt möglich, ob Sie Dateien der internen Datei-Speicherort oder unter Verwendung der bisherigen Logik, mit einer Präferenz in der Anwendung-config.xml-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu "config.xml":
+Es ist nun möglich, auszuwählen, ob zum Speichern von Dateien in den internen Datei-Speicherort oder unter Verwendung der bisherigen Logik mit einer Vorliebe in Ihrer Anwendung `config.xml` Datei. Hierzu fügen Sie eines dieser beiden Linien zu `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Ohne diese Zeile wird die Datei-Erweiterung "Kompatibilität" als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.
+Ohne diese Zeile das Datei-Plugin verwendet `Compatibility` als Standard. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.
-Wenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann setzen Sie die Einstellung auf "Kompatibilität". Wechseln die Location auf "Internal" würde bedeuten, dass Benutzer, die aktualisieren Sie ihre Anwendung, möglicherweise nicht auf ihre zuvor gespeicherte Dateien, abhängig von ihrem Gerät zugreifen.
+Wenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann legen Sie die Voreinstellung "" auf `Compatibility` . Wechseln die Location auf "Internal" würde bedeuten, dass Benutzer, die aktualisieren Sie ihre Anwendung, möglicherweise nicht auf ihre zuvor gespeicherte Dateien, abhängig von ihrem Gerät zugreifen.
-Wenn Ihre Anwendung neu ist, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die "interne" Einstellung im Allgemeinen empfohlen.
+Wenn die Anwendung neu, oder nie zuvor, Dateien im Dateisystem persistent gespeichert hat, dann die `Internal` Einstellung wird im Allgemeinen empfohlen.
## iOS Macken
+* `cordova.file.applicationStorageDirectory`ist schreibgeschützt; zum Speichern von Dateien im Stammverzeichnis der Versuch schlägt fehl. Verwenden Sie eine der anderen `cordova.file.*` für iOS definierten Eigenschaften (nur `applicationDirectory` und `applicationStorageDirectory` sind schreibgeschützt).
* `FileReader.readAsText(blob, encoding)`
* Die `encoding` Parameter wird nicht unterstützt und UTF-8-Kodierung ist immer wirksam.
@@ -112,28 +173,29 @@ Wenn Ihre Anwendung neu ist, oder nie zuvor Dateien im Dateisystem persistent ge
Es gibt zwei gültige Speicherorte persistente Dateien auf ein iOS-Gerät speichern: das Dokumenten-Verzeichnis und das Verzeichnis Library. Frühere Versionen des Plugins gespeichert immer nur persistente Dateien im Verzeichnis Dokumente. Dies hatte den Nebeneffekt einer Anwendung Dateien in iTunes, die oft unbeabsichtigte, speziell für Anwendungen, die viele kleine Dateien behandeln war, sichtbar zu machen, anstatt komplette Dokumente für den Export, die den beabsichtigten Zweck des Verzeichnisses ist zu produzieren.
-Es ist jetzt möglich, ob Sie Dateien in Dokumente oder Verzeichnis Library mit einer Präferenz in der Anwendung-config.xml-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu "config.xml":
+Es ist nun möglich, auszuwählen, ob zum Speichern von Dateien in Dokumente oder Verzeichnis Library mit einer Vorliebe in Ihrer Anwendung `config.xml` Datei. Hierzu fügen Sie eines dieser beiden Linien zu `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Ohne diese Zeile wird die Datei-Erweiterung "Kompatibilität" als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.
+Ohne diese Zeile das Datei-Plugin verwendet `Compatibility` als Standard. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.
-Wenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann setzen Sie die Einstellung auf "Kompatibilität". Wechseln zu "Library" Position würde bedeuten, dass Benutzer, die ihre Anwendung aktualisieren nicht in der Lage wäre, ihre zuvor gespeicherte Dateien zugreifen.
+Wenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann legen Sie die Voreinstellung "" auf `Compatibility` . Wechsel der Lage zu `Library` würde bedeuten, dass Benutzer, aktualisieren Sie ihre Anwendung, nicht in der Lage, ihre zuvor gespeicherte Dateien zugreifen.
-Wenn die Anwendung neu, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die Einstellung "Bibliothek" empfohlen.
+Wenn die Anwendung neu, oder nie zuvor, Dateien im Dateisystem persistent gespeichert hat, dann die `Library` Einstellung wird im Allgemeinen empfohlen.
-### Firefox OS Macken
+## Firefox OS Macken
Der Datei-System-API wird von Firefox-OS nicht nativ unterstützt und wird als ein Shim auf IndexedDB implementiert.
* Schlägt nicht fehl, wenn Sie nicht leere Verzeichnisse entfernen
* Metadaten wird für Verzeichnisse nicht unterstützt.
-* Bietet keine Unterstützung für `requestAllFileSystems` und `resolveLocalFileSystemURI` Methoden
* Methoden `copyTo` und `moveTo` unterstützen keine Verzeichnisse
+Die folgenden Datenpfade werden unterstützt: * `applicationDirectory` -verwendet `xhr` um lokale Dateien zu erhalten, die mit der app verpackt sind. * `dataDirectory` - Für persistente app-spezifische Daten-Dateien. * `cacheDirectory` -Cache-Dateien, die app startet überleben sollte (Apps sollten nicht vom Betriebssystem zum Löschen von Dateien hier verlassen).
+
## Upgrade Notes
In v1.0.0 des Plugins die `FileEntry` und `DirectoryEntry` Strukturen haben sich geändert, um mehr im Einklang mit der veröffentlichten Spezifikation zu sein.
@@ -153,7 +215,7 @@ Mit v1.0.0 das `fullPath` -Attribut ist der Pfad zu der Datei, *relativ zum Stam
Wenn Ihre Anwendung mit absoluter Gerätepfade arbeitet und Sie zuvor diese Pfade durch abgerufenen die `fullPath` -Eigenschaft des `Entry` Objekte, dann Sie Ihren Code mithilfe von update sollte `entry.toURL()` statt.
-Für rückwärts Kompatibilität, die `resolveLocalFileSystemURL()` -Methode akzeptiert einen Absolute-Gerätepfad und kehren ein `Entry` -Objekt entspricht, solange diese Datei innerhalb von vorübergehenden oder dauerhaften Dateisysteme existiert.
+Für rückwärts Kompatibilität, die `resolveLocalFileSystemURL()` -Methode akzeptiert einen Absolute-Gerätepfad und kehren ein `Entry` Objekt entspricht, solange diese Datei innerhalb existiert der `TEMPORARY` oder `PERSISTENT` Dateisysteme.
Dies wurde vor allem ein Problem mit dem File-Transfer-Plugin, die zuvor-Absolute-Gerätepfade verwendet (und kann damit noch einverstanden). Es wurde aktualisiert, um ordnungsgemäß mit Dateisystem-URLs, so anstelle `entry.fullPath` mit `entry.toURL()` sollte lösen Sie alle Probleme, die immer des Plugin zum Arbeiten mit Dateien auf dem Gerät.
@@ -168,18 +230,20 @@ die benutzt werden können, um die Datei eindeutig zu identifizieren.
Wenn ein Fehler ausgelöst wird, wird eines der folgenden Codes verwendet werden.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Code | Konstante |
+| ----:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Konfigurieren das Plugin (Optional)
@@ -191,21 +255,21 @@ Die Menge der verfügbaren Dateisysteme kann pro Plattform konfiguriert sein. Er
### Android
-* Dateien: interne Datei-Speicher-Verzeichnis der Anwendung
-* Dateien-extern: Verzeichnis der Anwendung externe Datei Speicher
-* Sdcard: das externe Globaldatei-Speicherverzeichnis (Dies ist die Wurzel der SD-Karte, sofern installiert). Sie müssen die `android.permission.WRITE_EXTERNAL_STORAGE` Erlaubnis, diese zu verwenden.
-* Cache: internen Cache-Verzeichnis der Anwendung
-* Cache-extern: externer Cache-Verzeichnis der Anwendung
-* Wurzel: das gesamte Gerät-Dateisystem
+* `files`: Die Anwendung interner Speicher Dateiverzeichnis
+* `files-external`: Das Verzeichnis der Anwendung externe Datei Speicher
+* `sdcard`: Das externe Globaldatei-Speicherverzeichnis (Dies ist die Wurzel der SD-Karte, sofern installiert). Sie müssen die `android.permission.WRITE_EXTERNAL_STORAGE` Erlaubnis, diese zu verwenden.
+* `cache`: Internen Cache-Verzeichnis der Anwendung
+* `cache-external`: Die Anwendung externer Cache-Verzeichnis
+* `root`: Das gesamte Gerät-Dateisystem
Android unterstützt auch eine spezielle Dateisystem mit dem Namen "Dokumente", die ein Unterverzeichnis "/ Dokumente /" die "Dateien" Dateisystem darstellt.
### iOS
-* Bibliothek: Bibliothek-Verzeichnis der Anwendung
-* Dokumente: Dokumente-Verzeichnis der Anwendung
-* Cache: Cache-Verzeichnis der Anwendung
-* Bundle: die Anwendung Bündel; den Speicherort der die app selbst auf dem Datenträger (schreibgeschützt)
-* Wurzel: das gesamte Gerät-Dateisystem
+* `library`: Bibliothek das Anwendungsverzeichnis
+* `documents`: Dokumente das Anwendungsverzeichnis
+* `cache`: Cache-Verzeichnis der Anwendung
+* `bundle`: Die Anwendung Bündel; den Speicherort der die app selbst auf dem Datenträger (schreibgeschützt)
+* `root`: Das gesamte Gerät-Dateisystem
-Standardmäßig können die Bibliothek und Dokumenten-Verzeichnisse mit iCloud synchronisiert werden. Sie können auch beantragen, zwei zusätzliche Dateisysteme, "Bibliothek-Nosync" und "Dokumente-Nosync", die einem speziellen nicht synchronisierten Verzeichnis im Dateisystem Bibliothek oder Dokumente darstellen.
\ No newline at end of file
+Standardmäßig können die Bibliothek und Dokumenten-Verzeichnisse mit iCloud synchronisiert werden. Können Sie auch beantragen, zwei zusätzliche Dateisysteme, `library-nosync` und `documents-nosync` , die repräsentieren eine spezielle nicht synchronisierten Verzeichnis innerhalb der `/Library` oder `/Documents` Dateisystem.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
index 7dd2edd..eb5e689 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -56,27 +56,87 @@ Para tener una visión general de otras opciones de almacenamiento, consulte [Gu
A partir de v1.2.0, URLs a directorios de sistema de archivos importantes son proporcionadas. Cada dirección URL está en la forma *file:///path/to/spot/*y se puede convertir en un `DirectoryEntry` usando`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Directorio Read-only donde está instalada la aplicación. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Directorio Read-only donde está instalada la aplicación. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.applicationStorageDirectory`-Raíz de almacenamiento escribible privado de app. (*iOS*, *Android*)
+* `cordova.file.applicationStorageDirectory`-Directorio del entorno limitado de la aplicación; en iOS esta ubicación es de sólo lectura (pero subdirectorios específicos [como `/Documents` ] son de lectura y escritura). Todos los datos contenidos dentro es privado para la aplicación. ( *iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.dataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación. (*iOS*, *Android*)
+* `cordova.file.dataDirectory`-Almacenamiento de datos persistente y privadas dentro de entorno limitado de la aplicación utilizando la memoria interna (en Android, si necesitas usar memoria externa, use `.externalDataDirectory` ). En iOS, este directorio no está sincronizado con iCloud (utilice `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-Almacena en caché los archivos que deben sobrevivir se reinicia la aplicación. Aplicaciones no deben confiar en el sistema operativo para eliminar los archivos de aquí. (*iOS*, *Android*)
+* `cordova.file.cacheDirectory`-Directorio para los archivos de datos almacenados en caché o los archivos que su aplicación puede volver a crear fácilmente. El sistema operativo puede borrar estos archivos cuando el dispositivo se agota en almacenamiento de información, sin embargo, aplicaciones no deben confiar en el sistema operativo para eliminar los archivos de aquí. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.externalApplicationStorageDirectory`-Espacio aplicación de almacenamiento externo. (*iOS*, *Android*)
+* `cordova.file.externalApplicationStorageDirectory`-Espacio aplicación de almacenamiento externo. (*Android*)
-`cordova.file.externalDataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación de almacenamiento externo. (*Android*)
+* `cordova.file.externalDataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación de almacenamiento externo. (*Android*)
-`cordova.file.externalCacheDirectory`-Caché aplicación de almacenamiento externo. (*Android*)
+* `cordova.file.externalCacheDirectory`-Caché aplicación de almacenamiento externo. (*Android*)
-`cordova.file.externalRootDirectory`-Raíz de almacenamiento externo (tarjeta SD). (*Android*)
+* `cordova.file.externalRootDirectory`-Raíz de almacenamiento externo (tarjeta SD). (*Android*, *BlackBerry 10*)
-`cordova.file.tempDirectory`-Directorio temporal que puede borrar el sistema operativo en sí. (*iOS*)
+* `cordova.file.tempDirectory`-Directorio temporal que puede borrar el sistema operativo en sí. No confíe en el sistema operativo para borrar este directorio; su aplicación siempre debe eliminar archivos según corresponda. (*iOS*)
-`cordova.file.syncedDataDirectory`-Contiene los archivos de la aplicación específica que deben ser sincronizados (e.g. a iCloud). (*iOS*)
+* `cordova.file.syncedDataDirectory`-Contiene los archivos de la aplicación específica que deben ser sincronizados (e.g. a iCloud). (*iOS*)
-`cordova.file.documentsDirectory`-Archivos privados a la aplicación, pero que son significativos para otros applciations (por ejemplo archivos de Office). (*iOS*)
+* `cordova.file.documentsDirectory`-Archivos privados a la aplicación, pero que son significativos para otra aplicación (por ejemplo archivos de Office). (*iOS*)
+
+* `cordova.file.sharedDirectory`-Archivos disponibles globalmente para todas las aplicaciones (*BlackBerry 10*)
+
+## Diseños de sistema de archivo
+
+Aunque técnicamente un detalle de la implementación, puede ser muy útil saber cómo la `cordova.file.*` mapa de propiedades en trazados físicos en un dispositivo real.
+
+### iOS diseño de sistema de archivo
+
+| Ruta de dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | sincronización | privado |
+|:-------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:----------:|:--------------:|:-------:|
+| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r/o | N / A | N / A | N / A | Sí |
+| `appname.app/` | applicationDirectory | Bundle | r/o | N / A | N / A | N / A | Sí |
+| `www/` | - | - | r/o | N / A | N / A | N / A | Sí |
+| `Documents/` | documentsDirectory | documentos | r/w | Sí | No | Sí | Sí |
+| `NoCloud/` | - | documentos-nosync | r/w | Sí | No | No | Sí |
+| `Library` | - | Biblioteca | r/w | Sí | No | ¿Sí? | Sí |
+| `NoCloud/` | dataDirectory | Biblioteca-nosync | r/w | Sí | No | No | Sí |
+| `Cloud/` | syncedDataDirectory | - | r/w | Sí | No | Sí | Sí |
+| `Caches/` | cacheDirectory | caché | r/w | Sí * | Si \* * *| | No | Sí |
+| `tmp/` | tempDirectory | - | r/w | No * * | Si \* * *| | No | Sí |
+
+* Archivos persisten a través de la aplicación se reinicia y actualizaciones, pero este directorio puede ser despejó cuando el OS desea. Su aplicación debe ser capaz de recrear cualquier contenido que puede ser eliminado.
+
+* * Archivos pueden persistir a través de la aplicación se reinicia, pero no confiar en este comportamiento. Los archivos no se garantizan que persisten a través de actualizaciones. Su aplicación debe eliminar los archivos de este directorio cuando es aplicable, como el sistema operativo no garantiza cuando (o incluso si) estos archivos se quitan.
+
+\* * *| OS la puede borrar el contenido de este directorio cuando se siente que es necesario, pero no dependen de éste. Debe borrar este directorio según sea apropiado para su aplicación.
+
+### Disposición del sistema Android File
+
+| Ruta de dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | privado |
+|:----------------------------------------- |:----------------------------------- |:------------------------- |:-----:|:-------------:|:----------:|:-------:|
+| `File:///android_asset/` | applicationDirectory | | r/o | N / A | N / A | Sí |
+| `/Data/data/< id de aplicación > /` | applicationStorageDirectory | - | r/w | N / A | N / A | Sí |
+| `cache` | cacheDirectory | caché | r/w | Sí | Sí * | Sí |
+| `files` | dataDirectory | archivos | r/w | Sí | No | Sí |
+| `Documents` | | documentos | r/w | Sí | No | Sí |
+| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sí | No | No |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Sí | No | No |
+| `cache` | externalCacheDirectry | caché-externo | r/w | Sí | No * * | No |
+| `files` | externalDataDirectory | archivos externos | r/w | Sí | No | No |
+
+* El sistema operativo puede eliminar periódicamente este directorio, pero no dependen de este comportamiento. Borrar el contenido de este directorio según sea apropiado para su aplicación. El contenido de este directorio debe un usuario purga la caché manualmente, se eliminan.
+
+* * El sistema operativo no borra este directorio automáticamente; Usted es responsable de administrar el contenido mismo. Deberá el usuario purga la caché manualmente, se extraen los contenidos del directorio.
+
+**Nota**: Si no se puede montar de almacenamiento externo, el `cordova.file.external*` Propiedades`null`.
+
+### Disposición del sistema blackBerry 10 archivo
+
+| Ruta de dispositivo | `Cordova.file.*` | ¿r/w? | ¿persistente? | OS despeja | privado |
+|:------------------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:----------:|:-------:|
+| `File:///accounts/1000/AppData/ < id de aplicación > /` | applicationStorageDirectory | r/o | N / A | N / A | Sí |
+| `app/native` | applicationDirectory | r/o | N / A | N / A | Sí |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sí | Sí |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sí | No | Sí |
+| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sí | No | No |
+| `File:///accounts/1000/shared` | sharedDirectory | r/w | Sí | No | No |
+
+*Nota*: cuando se implementa la aplicación al trabajo de perímetro, todos los caminos son relativos a /accounts/1000-enterprise.
## Rarezas Android
@@ -88,23 +148,24 @@ Hay múltiples ubicaciones válidas para almacenar archivos persistentes en un d
Las versiones anteriores del plugin elegiría la ubicación de los archivos temporales y persistentes en el arranque, basado en si el dispositivo afirmó que fue montado en la tarjeta SD (o partición de almacenamiento equivalente). Si fue montada en la tarjeta SD, o una partición de gran almacenamiento interno estaba disponible (como en dispositivos de Nexus,) y luego los archivos persistentes se almacenaría en la raíz de ese espacio. Esto significaba que todas las apps Cordova podían ver todos los archivos disponibles en la tarjeta.
-Si la tarjeta SD no estaba disponible, entonces las versiones anteriores almacenará datos bajo /data/data /<packageid>, que aísla las apps del otro, pero todavía puede causar datos ser compartido entre los usuarios.
+Si la tarjeta SD no estaba disponible, entonces versiones anteriores podría almacenar datos debajo de `/data/data/<packageId>` , que aísla las apps del otro, pero puede todavía causa datos para ser compartido entre los usuarios.
-Ahora es posible elegir si desea almacenar archivos en la ubicación de almacenamiento del archivo interno, o usando la lógica anterior, con preferencia en el archivo config.xml de su aplicación. Para ello, añada una de estas dos líneas en config.xml:
+Ahora es posible elegir si desea almacenar archivos en la ubicación de almacenamiento del archivo interno, o usando la lógica anterior, con una preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Sin esta línea, el archivo plugin utilizará "Compatibilidad" como el valor por defecto. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
+Sin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
-Si su solicitud se ha enviado previamente a los usuarios, mediante una mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces se debe establecer la preferencia a la "Compatibilidad". Cambiar la ubicación para "Internal" significa que los usuarios existentes que actualización su aplicación pueden ser incapaces de acceder a sus archivos previamente almacenadas, dependiendo de su dispositivo.
+Si su solicitud se ha enviado previamente a los usuarios, mediante una mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación para "Internal" significa que los usuarios existentes que actualización su aplicación pueden ser incapaces de acceder a sus archivos previamente almacenadas, dependiendo de su dispositivo.
-Si su solicitud es nueva, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, el ajuste "interno" se recomienda generalmente.
+Si su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Internal` generalmente se recomienda el ajuste.
## iOS rarezas
+* `cordova.file.applicationStorageDirectory`es de sólo lectura; intentar almacenar archivos en el directorio raíz fallará. Utilice uno de los `cordova.file.*` las propiedades definidas para iOS (sólo `applicationDirectory` y `applicationStorageDirectory` son de sólo lectura).
* `FileReader.readAsText(blob, encoding)`
* El `encoding` no se admite el parámetro, y codificación UTF-8 es siempre en efecto.
@@ -112,28 +173,29 @@ Si su solicitud es nueva, o nunca antes ha almacenado archivos en el sistema de
Hay dos ubicaciones válidas para almacenar archivos persistentes en un dispositivo iOS: el directorio de documentos y el directorio de biblioteca. Las versiones anteriores del plugin sólo almacenan archivos persistentes en el directorio de documentos. Esto tenía el efecto secundario de todos los archivos de la aplicación haciendo visible en iTunes, que era a menudo involuntarios, especialmente para aplicaciones que manejan gran cantidad de archivos pequeños, en lugar de producir documentos completos para la exportación, que es la finalidad del directorio.
-Ahora es posible elegir si desea almacenar archivos en los documentos o directorio de bibliotecas, con preferencia en el archivo config.xml de su aplicación. Para ello, añada una de estas dos líneas en config.xml:
+Ahora es posible elegir si desea almacenar archivos en los documentos o directorio de bibliotecas, con preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Sin esta línea, el archivo plugin utilizará "Compatibilidad" como el valor por defecto. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
+Sin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
-Si su solicitud se ha enviado previamente a los usuarios, mediante una mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces se debe establecer la preferencia a la "Compatibilidad". Cambiar la ubicación a la "Biblioteca" significa que los usuarios existentes que actualización su aplicación sería incapaces de acceder a sus archivos previamente almacenadas.
+Si su solicitud se ha enviado previamente a los usuarios, mediante una mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación de `Library` significa que los usuarios existentes que actualización su aplicación sería incapaces de acceder a sus archivos previamente almacenadas.
-Si su solicitud es nueva, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, el ajuste de "Biblioteca" generalmente se recomienda.
+Si su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Library` generalmente se recomienda el ajuste.
-### Firefox OS rarezas
+## Firefox OS rarezas
La API de sistema de archivo de forma nativa no es compatible con Firefox OS y se implementa como una cuña en la parte superior indexedDB.
* No falla cuando eliminar directorios no vacía
* No admite metadatos para directorios
-* No es compatible con `requestAllFileSystems` y `resolveLocalFileSystemURI` métodos
* Los métodos `copyTo` y `moveTo` no son compatibles con directorios
+Se admiten las siguientes rutas de datos: * `applicationDirectory` -usa `xhr` para obtener los archivos locales que están envasados con la aplicación. * `dataDirectory` - Para archivos de datos específicos de aplicación persistente. * `cacheDirectory` -En caché archivos que deben sobrevivir se reinicia la aplicación (aplicaciones no deben confiar en el sistema operativo para eliminar archivos aquí).
+
## Actualización de notas
En v1.0.0 de este plugin, la `FileEntry` y `DirectoryEntry` han cambiado las estructuras, para estar más acorde con las especificaciones publicadas.
@@ -153,7 +215,7 @@ Con v1.0.0, la `fullPath` es la ruta del archivo, *relativo a la raíz del siste
Si su aplicación funciona con dispositivo-absoluto-caminos, y previamente obtenido esos caminos a través de la `fullPath` propiedad de `Entry` objetos, entonces debe actualizar su código para utilizar `entry.toURL()` en su lugar.
-Para atrás compatibilidad, el `resolveLocalFileSystemURL()` método aceptará un dispositivo-absoluto-trayectoria y volverá un `Entry` objeto correspondiente, mientras exista ese archivo dentro de los sistemas de ficheros temporales o permanentes.
+Para atrás compatibilidad, el `resolveLocalFileSystemURL()` método aceptará un dispositivo-absoluto-trayectoria y volverá un `Entry` objeto correspondiente, mientras exista ese archivo dentro o el `TEMPORARY` o `PERSISTENT` filesystems.
Esto ha sido particularmente un problema con el plugin de transferencia de archivos, que anteriormente utilizado dispositivo-absoluto-caminos (y todavía puede aceptarlas). Se ha actualizado para que funcione correctamente con las URLs de FileSystem, reemplazando así `entry.fullPath` con `entry.toURL()` debe resolver cualquier problema conseguir ese plugin para trabajar con archivos en el dispositivo.
@@ -168,18 +230,20 @@ que puede utilizarse para identificar el archivo únicamente.
Cuando se produce un error, uno de los siguientes códigos se utilizará.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Código | Constante |
+| ------:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Configurando el Plugin (opcional)
@@ -191,21 +255,21 @@ El conjunto de los sistemas de ficheros disponibles puede ser configurado por pl
### Android
-* archivos: directorio de almacenamiento de archivo interno de la aplicación
-* archivos externos: directorio de almacenamiento de archivo externo de la aplicación
-* sdcard: el directorio de almacenamiento de archivo externo global (esta es la raíz de la tarjeta SD, si uno está instalado). Debes tener el `android.permission.WRITE_EXTERNAL_STORAGE` permiso para usar esto.
-* memoria caché: directorio de memoria caché interna de la aplicación
-* caché-externo: directorio de caché externo de la aplicación
-* raíz: el sistema de archivos de todo el dispositivo
+* `files`: Directorio de almacenamiento de archivos internos de la aplicación
+* `files-external`: Directorio de almacenamiento del la aplicación archivo externo
+* `sdcard`: El directorio de almacenamiento de archivo externo global (esta es la raíz de la tarjeta SD, si uno está instalado). Debes tener el `android.permission.WRITE_EXTERNAL_STORAGE` permiso para usar esto.
+* `cache`: Directorio de la aplicación la memoria caché interna
+* `cache-external`: Directorio de caché externo de la aplicación
+* `root`: El sistema de archivos de todo el dispositivo
Android también es compatible con un sistema de archivos especial llamado "documentos", que representa un subdirectorio "/ documentos /" dentro del sistema de archivos "archivos".
### iOS
-* Biblioteca: directorio de bibliotecas de la aplicación
-* documentos: directorio de documentos de la aplicación
-* memoria caché: directorio de caché de la aplicación
-* paquete: paquete de la aplicación; la ubicación de la aplicación en sí mismo en el disco (sólo lectura)
-* raíz: el sistema de archivos de todo el dispositivo
+* `library`: Directorio de la aplicación la biblioteca
+* `documents`: Directorio de documentos de la solicitud
+* `cache`: Directorio de caché de la aplicación la
+* `bundle`: Paquete la aplicación; la ubicación de la aplicación en sí mismo en el disco (sólo lectura)
+* `root`: El sistema de archivos de todo el dispositivo
-De forma predeterminada, los directorios de documentos y la biblioteca pueden ser sincronizados con iCloud. También puede solicitar dos sistemas adicionales, "biblioteca-nosync" y "documentos-nosync", que representan un directorio no-sincronizado especial dentro del sistema de ficheros de biblioteca o documentos.
\ No newline at end of file
+De forma predeterminada, los directorios de documentos y la biblioteca pueden ser sincronizados con iCloud. También puede solicitar dos sistemas de archivos adicionales, `library-nosync` y `documents-nosync` , que representa un directorio especial no sincronizados dentro de la `/Library` o `/Documents` sistema de ficheros.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/fa64fa54/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
index e7cce64..9549c7a 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -56,27 +56,87 @@ Pour un aperçu des autres options de stockage, consultez [guide d'entreposage d
À partir de v1.2.0, URL vers des répertoires de système de fichiers importants est fournis. Chaque URL est dans la forme *file:///path/to/spot/*et peut être converti en un `DirectoryEntry` à l'aide`window.resolveLocalFileSystemURL()`.
-`cordova.file.applicationDirectory`-Lecture seule répertoire où l'application est installée. (*iOS*, *Android*)
+* `cordova.file.applicationDirectory`-Lecture seule répertoire où l'application est installée. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.applicationStorageDirectory`-Racine de stockage accessible en écriture privé de l'application. (*iOS*, *Android*)
+* `cordova.file.applicationStorageDirectory`-Répertoire racine du bac à sable de l'application ; cet endroit est en lecture seule sur iOS (mais les sous-répertoires spécifiques [comme `/Documents` ] sont en lecture / écriture). Toutes les données qu'il contient est privé de l'application. ( *iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.dataDirectory`-Où placer les fichiers de données d'application spécifiques. (*iOS*, *Android*)
+* `cordova.file.dataDirectory`-Stockage des données persistants et privés au sein de bac à sable de l'application à l'aide de la mémoire interne (sur Android, si vous avez besoin d'utiliser une mémoire externe, utilisez `.externalDataDirectory` ). Sur iOS, ce répertoire n'est pas synchronisé avec iCloud (utiliser `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.cacheDirectory`-Mise en cache de fichiers qui doivent survivre app redémarre. Apps ne doivent pas compter sur le système d'exploitation pour supprimer les fichiers ici. (*iOS*, *Android*)
+* `cordova.file.cacheDirectory`-Répertoire pour les fichiers de données en mémoire cache ou les fichiers que votre application peut recréer facilement. L'OS peut supprimer ces fichiers lorsque l'appareil faiblit sur stockage, néanmoins, les applications ne doivent pas compter sur l'OS pour supprimer les fichiers ici. (*iOS*, *Android*, *BlackBerry 10*)
-`cordova.file.externalApplicationStorageDirectory`-Espace l'application sur le stockage externe. (*iOS*, *Android*)
+* `cordova.file.externalApplicationStorageDirectory`-Espace l'application sur le stockage externe. (*Android*)
-`cordova.file.externalDataDirectory`-Où placer les fichiers de données d'application spécifiques sur le stockage externe. (*Android*)
+* `cordova.file.externalDataDirectory`-Où placer les fichiers de données d'application spécifiques sur le stockage externe. (*Android*)
-`cordova.file.externalCacheDirectory`-Cache de l'application sur le stockage externe. (*Android*)
+* `cordova.file.externalCacheDirectory`-Cache de l'application sur le stockage externe. (*Android*)
-`cordova.file.externalRootDirectory`-Racine de stockage externe (carte SD). (*Android*)
+* `cordova.file.externalRootDirectory`-Racine de stockage externe (carte SD). (*Android*, *BlackBerry 10*)
-`cordova.file.tempDirectory`-Répertoire temp que l'OS peut effacer à volonté. (*iOS*)
+* `cordova.file.tempDirectory`-Répertoire temp que l'OS peut effacer à volonté. Ne comptez pas sur l'OS pour effacer ce répertoire ; votre application doit toujours supprimer les fichiers selon le cas. (*iOS*)
-`cordova.file.syncedDataDirectory`-Contient des fichiers d'app spécifique qui doivent se synchroniser (par exemple à iCloud). (*iOS*)
+* `cordova.file.syncedDataDirectory`-Contient des fichiers d'app spécifique qui doivent se synchroniser (par exemple à iCloud). (*iOS*)
-`cordova.file.documentsDirectory`-Fichiers privés à l'app, mais qui sont utiles à d'autres applications (par exemple les fichiers Office). (*iOS*)
+* `cordova.file.documentsDirectory`-Fichiers privés à l'app, mais qui sont significatives pour l'autre application (par exemple les fichiers Office). (*iOS*)
+
+* `cordova.file.sharedDirectory`-Fichiers disponibles globalement à toutes les applications (*BlackBerry 10*)
+
+## Structures de système de fichiers
+
+Bien que techniquement un détail d'implémentation, il peut être très utile de savoir comment les `cordova.file.*` carte de propriétés à des chemins d'accès physiques sur un périphérique réel.
+
+### iOS agencement de système de fichier
+
+| Chemin de l'unité | `Cordova.file.*` | `iosExtraFileSystems` | r/w ? | persistants ? | OS efface | Sync | privé |
+|:-------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:-----------:|:-----:|:-----:|
+| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r/o | N/A | N/A | N/A | Oui |
+| `appname.app/` | applicationDirectory | Bundle | r/o | N/A | N/A | N/A | Oui |
+| `www/` | - | - | r/o | N/A | N/A | N/A | Oui |
+| `Documents/` | documentsDirectory | documents | r/w | Oui | Non | Oui | Oui |
+| `NoCloud/` | - | documents-nosync | r/w | Oui | Non | Non | Oui |
+| `Library` | - | Bibliothèque | r/w | Oui | Non | Oui ? | Oui |
+| `NoCloud/` | dataDirectory | Bibliothèque-nosync | r/w | Oui | Non | Non | Oui |
+| `Cloud/` | syncedDataDirectory | - | r/w | Oui | Non | Oui | Oui |
+| `Caches/` | cacheDirectory | cache | r/w | Oui * | Oui \* * *| | Non | Oui |
+| `tmp/` | tempDirectory | - | r/w | Ne * * | Oui \* * *| | Non | Oui |
+
+* Fichiers persistent à travers les redémarrages de l'application et mises à niveau, mais ce répertoire peut être effacé à chaque fois que les désirs de l'OS. Votre application doit être en mesure de recréer tout contenu qui pourrait être supprimé.
+
+* * Fichiers peuvent persister redémarrages de l'application, mais ne vous fiez pas ce comportement. Les fichiers ne sont pas garantis à persister dans l'ensemble de mises à jour. Votre application doit supprimer les fichiers de ce répertoire lorsqu'elle s'applique, comme le système d'exploitation ne garantit pas quand (ou même si) ces fichiers sont supprimés.
+
+\* * *| L'OS peut effacer le contenu de ce répertoire chaque fois qu'il se sent il est nécessaire, mais ne comptez pas là-dessus. Vous devez supprimer ce répertoire comme approprié pour votre application.
+
+### Agencement de système de fichiers Android
+
+| Chemin de l'unité | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w ? | persistants ? | OS efface | privé |
+|:----------------------------------- |:----------------------------------- |:------------------------- |:-----:|:-------------:|:---------:|:-----:|
+| `file:///android_asset/` | applicationDirectory | | r/o | N/A | N/A | Oui |
+| `/ données/data/app < id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | Oui |
+| `cache` | cacheDirectory | cache | r/w | Oui | Oui * | Oui |
+| `files` | dataDirectory | fichiers | r/w | Oui | Non | Oui |
+| `Documents` | | documents | r/w | Oui | Non | Oui |
+| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Oui | Non | Non |
+| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Oui | Non | Non |
+| `cache` | externalCacheDirectry | cache-externe | r/w | Oui | Ne * * | Non |
+| `files` | externalDataDirectory | fichiers externes | r/w | Oui | Non | Non |
+
+* Le système d'exploitation peut effacer périodiquement ce répertoire, mais ne vous fiez pas ce comportement. Effacer le contenu de ce répertoire comme approprié pour votre application. Un utilisateur doit purger le cache manuellement, le contenu de ce répertoire est supprimé.
+
+* * The OS vous n'effacez pas ce répertoire automatiquement ; vous êtes chargé de gérer le contenu vous-même. L'utilisateur devrait purger le cache manuellement, le contenu du répertoire est supprimé.
+
+**Remarque**: si le stockage externe ne peut pas être monté, les `cordova.file.external*` sont des propriétés`null`.
+
+### Configuration du système blackBerry 10 fichier
+
+| Chemin de l'unité | `Cordova.file.*` | r/w ? | persistants ? | OS efface | privé |
+|:--------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:---------:|:-----:|
+| `file:///Accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r/o | N/A | N/A | Oui |
+| `app/native` | applicationDirectory | r/o | N/A | N/A | Oui |
+| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Non | Oui | Oui |
+| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Oui | Non | Oui |
+| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Oui | Non | Non |
+| `file:///Accounts/1000/Shared` | sharedDirectory | r/w | Oui | Non | Non |
+
+*Remarque*: lorsque l'application est déployée dans le périmètre de travail, tous les chemins sont par rapport à /accounts/1000-enterprise.
## Quirks Android
@@ -88,23 +148,24 @@ Il y a plusieurs emplacements valides pour stocker des fichiers persistants sur
Les versions précédentes du plugin choisirait l'emplacement des fichiers temporaires et persistantes au démarrage, basé sur la question de savoir si le dispositif réclamé que la carte SD (ou une partition de stockage équivalent) a été montée. Si la carte SD a été montée, ou si une partition de stockage interne importante était disponible (comme sur les appareils Nexus,) puis les fichiers persistants seraient stockés dans la racine de cet espace. Cela signifie que toutes les apps de Cordova pouvaient voir tous les fichiers disponibles sur la carte.
-Si la carte SD n'était pas disponible, alors les versions précédentes seraient stocker des données sous/données/data /<packageid>, qui isole les apps de l'autre, mais peuvent encore provoquer des données à partager entre les utilisateurs.
+Si la carte SD n'était pas disponible, les versions précédentes pourraient stocker des données sous `/data/data/<packageId>` , qui isole des apps de l'autre, mais peut encore cause données à partager entre les utilisateurs.
-Il est maintenant possible de choisir de stocker les fichiers dans l'emplacement de stockage de fichier interne, ou en utilisant la logique précédente, avec une préférence dans le fichier config.xml de votre application. Pour ce faire, ajoutez l'un des ces deux lignes au fichier config.xml :
+Il est maintenant possible de choisir de stocker les fichiers dans l'emplacement de stockage de fichier interne, ou en utilisant la logique précédente, avec une préférence au sein de votre application `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />
-Sans cette ligne, le fichier plugin utilisera la valeur par défaut « Compatibilité ». Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.
+Sans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.
-Si votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence à la « Compatibilité ». Commutation de l'emplacement « Internal » signifierait que les utilisateurs existants qui mettre à niveau leur application peuvent être impossible d'accéder à leurs fichiers déjà enregistrés, selon leur appareil.
+Si votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Commutation de l'emplacement « Internal » signifierait que les utilisateurs existants qui mettre à niveau leur application peuvent être impossible d'accéder à leurs fichiers déjà enregistrés, selon leur appareil.
-Si votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, alors le paramètre « interne » est généralement recommandé.
+Si votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Internal` réglage est généralement recommandé.
## iOS Quirks
+* `cordova.file.applicationStorageDirectory`est en lecture seule ; tentative de stocker des fichiers dans le répertoire racine échoue. Utilisez l'une de l'autre `cordova.file.*` les propriétés définies pour iOS (seulement `applicationDirectory` et `applicationStorageDirectory` sont en lecture seule).
* `FileReader.readAsText(blob, encoding)`
* Le `encoding` paramètre n'est pas pris en charge, et le codage UTF-8 est toujours en vigueur.
@@ -112,28 +173,29 @@ Si votre application est nouvelle ou a jamais précédemment stocké les fichier
Il y a deux emplacements valides pour stocker des fichiers persistants sur un appareil iOS : le répertoire de Documents et le répertoire de la bibliothèque. Les versions précédentes du plugin stockaient ne jamais fichiers persistants dans le répertoire de Documents. Cela a eu l'effet secondaire de rendre tous les fichiers de l'application visible dans iTunes, qui était souvent inattendus, en particulier pour les applications qui traitent beaucoup de petits fichiers, plutôt que de produire des documents complets destinés à l'exportation, qui est l'objectif visé par le répertoire.
-Il est maintenant possible de choisir de stocker les fichiers dans le répertoire de bibliothèque, avec une préférence dans le fichier config.xml de votre application ou de documents. Pour ce faire, ajoutez l'un des ces deux lignes au fichier config.xml :
+Il est maintenant possible de choisir de stocker les fichiers dans le répertoire de bibliothèque, avec une préférence au sein de votre application ou de documents `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :
<preference name="iosPersistentFileLocation" value="Library" />
<preference name="iosPersistentFileLocation" value="Compatibility" />
-Sans cette ligne, le fichier plugin utilisera la valeur par défaut « Compatibilité ». Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.
+Sans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.
-Si votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence à la « Compatibilité ». L'emplacement de la « Bibliothèque » de commutation signifierait que les utilisateurs existants qui mettre à niveau leur application serait incapables d'accéder à leurs fichiers déjà enregistrés.
+Si votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Changer l'emplacement de `Library` voudrait dire que les utilisateurs existants qui mettre à niveau leur application serait incapables d'accéder à leurs fichiers déjà enregistrés.
-Si votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, alors le paramètre « Library » est généralement recommandé.
+Si votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Library` réglage est généralement recommandé.
-### Firefox OS Quirks
+## Firefox OS Quirks
L'API de système de fichier n'est pas nativement pris en charge par Firefox OS et est implémentée comme une cale d'épaisseur sur le dessus d'indexedDB.
* Ne manque pas lors de la suppression des répertoires non vide
* Ne supporte pas les métadonnées pour les répertoires
-* Ne prend pas en charge `requestAllFileSystems` et `resolveLocalFileSystemURI` méthodes
* Méthodes `copyTo` et `moveTo` ne prennent pas en charge les répertoires
+Les chemins de données suivants sont pris en charge: * `applicationDirectory` -utilise `xhr` pour obtenir des fichiers les qui sont emballés avec le $ $ etAPP. * `dataDirectory` - Pour les fichiers de données persistantes de app spécifique. * `cacheDirectory` -Mise en cache de fichiers qui doivent survivre les redémarrages de l'application (les applications ne doivent pas compter sur le système d'exploitation pour supprimer les fichiers ici).
+
## Notes de mise à niveau
Dans v1.0.0 de ce plugin, la `FileEntry` et `DirectoryEntry` structures ont changé, pour être plus conforme à la spécification publiée.
@@ -153,7 +215,7 @@ Avec v1.0.0, le `fullPath` attribut contient le chemin vers le fichier, *par rap
Si votre application fonctionne avec le dispositif-absolu-chemins, et que vous avez récupéré précédemment ces chemins à travers la `fullPath` propriété de `Entry` objets, puis vous devez mettre à jour votre code d'utiliser `entry.toURL()` à la place.
-Pour vers l'arrière compatibilité, la `resolveLocalFileSystemURL()` méthode acceptera un chemin absolu de l'unité et retournera un `Entry` objet correspond, tant que ce fichier existe au sein des systèmes de fichiers temporaires ou permanents.
+Pour vers l'arrière compatibilité, le `resolveLocalFileSystemURL()` méthode acceptera un chemin absolu de l'unité et retournera un `Entry` objet correspond, tant que ce fichier existe au sein de soit le `TEMPORARY` ou `PERSISTENT` systèmes de fichiers.
Cela a été particulièrement un problème avec le plugin de transfert de fichiers, qui autrefois périphérique-absolu-chemins (et peut encore accepter). Il a été mis à jour pour fonctionner correctement avec des URL de système de fichiers, remplaçant ainsi `entry.fullPath` avec `entry.toURL()` devrait résoudre tout problème obtenir ce plugin pour travailler avec des fichiers sur le périphérique.
@@ -168,18 +230,20 @@ qui peut servir à identifier de manière unique le fichier.
Lorsqu'une erreur est levée, l'un des codes suivants sera utilisé.
-* 1 = NOT\_FOUND\_ERR
-* 2 = SECURITY_ERR
-* 3 = ABORT_ERR
-* 4 = NOT\_READABLE\_ERR
-* 5 = ENCODING_ERR
-* 6 = NO\_MODIFICATION\_ALLOWED_ERR
-* 7 = INVALID\_STATE\_ERR
-* 8 = SYNTAX_ERR
-* 9 = INVALID\_MODIFICATION\_ERR
-* 10 = QUOTA\_EXCEEDED\_ERR
-* 11 = TYPE\_MISMATCH\_ERR
-* 12 = PATH\_EXISTS\_ERR
+| Code | Constant |
+| ----:|:----------------------------- |
+| 1 | `NOT_FOUND_ERR` |
+| 2 | `SECURITY_ERR` |
+| 3 | `ABORT_ERR` |
+| 4 | `NOT_READABLE_ERR` |
+| 5 | `ENCODING_ERR` |
+| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
+| 7 | `INVALID_STATE_ERR` |
+| 8 | `SYNTAX_ERR` |
+| 9 | `INVALID_MODIFICATION_ERR` |
+| 10 | `QUOTA_EXCEEDED_ERR` |
+| 11 | `TYPE_MISMATCH_ERR` |
+| 12 | `PATH_EXISTS_ERR` |
## Configuration du Plugin (facultatif)
@@ -191,21 +255,21 @@ L'ensemble des systèmes de fichiers disponibles peut être configurée par plat
### Android
-* fichiers : répertoire de stockage de fichier interne de l'application
-* fichiers externes : répertoire de l'application de stockage de fichier externe
-* carte SD : le répertoire de stockage global fichier externe (c'est la racine de la carte SD, s'il est installé). Vous devez avoir la `android.permission.WRITE_EXTERNAL_STORAGE` permission de l'utiliser.
-* cache : répertoire de cache interne de l'application
-* cache-externe : répertoire de cache externe de l'application
-* racine : le système de fichiers de tout dispositif
+* `files`: Répertoire de stockage de l'application le fichier interne
+* `files-external`: Répertoire de stockage de l'application le fichier externe
+* `sdcard`: Le répertoire de stockage global fichier externe (c'est la racine de la carte SD, s'il est installé). Vous devez avoir la `android.permission.WRITE_EXTERNAL_STORAGE` permission de l'utiliser.
+* `cache`: Répertoire de cache interne de l'application
+* `cache-external`: Répertoire de cache externe de l'application
+* `root`: Le système de fichiers de tout dispositif
Android prend également en charge un système de fichiers spécial nommé « documents », qui représente un sous-répertoire « / Documents / » dans le système de fichiers « files ».
### iOS
-* Bibliothèque : répertoire de bibliothèque de l'application
-* documents : répertoire de Documents de l'application
-* cache : répertoire de Cache de l'application
-* Bundle : bundle de l'application ; l'emplacement de l'application elle-même sur disque (lecture seule)
-* racine : le système de fichiers de tout dispositif
+* `library`: Répertoire de l'application la
+* `documents`: Répertoire de Documents de l'application la
+* `cache`: Répertoire du Cache de l'application la
+* `bundle`: Bundle de l'application ; l'emplacement de l'application elle-même sur disque (lecture seule)
+* `root`: Le système de fichiers de tout dispositif
-Par défaut, vous peuvent synchroniser les répertoires de la bibliothèque et les documents à iCloud. Vous pouvez également demander des deux systèmes de fichiers supplémentaires, « bibliothèque-nosync » et « documents-nosync », qui représentent un répertoire spécial non synchronisées dans le système de fichiers de bibliothèque ou de Documents.
\ No newline at end of file
+Par défaut, vous peuvent synchroniser les répertoires de la bibliothèque et les documents à iCloud. Vous pouvez également demander des deux autres systèmes de fichiers, `library-nosync` et `documents-nosync` , qui représentent un répertoire spécial non synchronisées dans le `/Library` ou `/Documents` système de fichiers.
\ No newline at end of file