cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ldel...@apache.org
Subject [09/17] Lisa testing pulling in plugins for plugin: cordova-plugin-file
Date Mon, 07 Jul 2014 17:50:46 GMT
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/9f937b71/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
new file mode 100644
index 0000000..fec09ae
--- /dev/null
+++ b/doc/pl/index.md
@@ -0,0 +1,201 @@
+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# 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].
+
+ [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
+
+## Instalacji
+
+    cordova plugin add org.apache.cordova.file
+    
+
+## Obsługiwane platformy
+
+*   Amazon ogień OS
+*   Android
+*   Jeżyna 10
+*   iOS
+*   Windows Phone 7 i 8 *
+*   Windows 8 *
+*   Firefox OS
+
+* *Nie obsługują te platformy `FileReader.readAsArrayBuffer` , ani `FileWriter.write(blob)`
.*
+
+## Gdzie przechowywać pliki
+
+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.applicationStorageDirectory`-Pierwiastek z prywatnego składowania zapisu aplikacji.
(*iOS*, *Android*)
+
+`cordova.file.dataDirectory`-Gdzie umieścić pliki dane specyficzne dla aplikacji. (*iOS*,
*Android*)
+
+`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.externalApplicationStorageDirectory`-Stosowania przestrzeni na zewnętrznej
pamięci masowej. (*iOS*, *Android*)
+
+`cordova.file.externalDataDirectory`-Gdzie umieścić pliki danych specyficznych dla aplikacji
na zewnętrznej pamięci masowej. (*Android*)
+
+`cordova.file.externalCacheDirectory`-Pamięci podręcznej aplikacji na zewnętrznej pamięci
masowej. (*Android*)
+
+`cordova.file.externalRootDirectory`-Korzeń zewnętrznej pamięci masowej (karty SD). (*Android*)
+
+`cordova.file.tempDirectory`-Temp katalogu systemu operacyjnego można wyczyścić w będzie.
(*iOS*)
+
+`cordova.file.syncedDataDirectory`-Posiada pliki specyficzne dla aplikacji, które powinny
być zsynchronizowane (np. do iCloud). (*iOS*)
+
+`cordova.file.documentsDirectory`-Pliki prywatne do aplikacji, ale że są znaczące dla
innych applciations (np. plików pakietu Office). (*iOS*)
+
+## 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.
+
+ [4]: 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.
+
+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:
+
+    <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.
+
+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 jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików
trwałe, ustawienie "wewnętrznego" Generalnie jest zalecane.
+
+## iOS dziwactwa
+
+*   `FileReader.readAsText(blob, encoding)` 
+    *   `encoding`Parametr nie jest obsługiwana, i kodowanie UTF-8 jest zawsze w efekcie.
+
+### iOS lokalizacja przechowywania trwałych
+
+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:
+
+    <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.
+
+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 jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików
trwałe, ustawienie "Biblioteki" Generalnie jest zalecane.
+
+### 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
+
+## Uaktualniania notatek
+
+W v1.0.0 ten plugin `FileEntry` i `DirectoryEntry` struktur zmieniły się, aby być bardziej
zgodnie z opublikowaną specyfikacją.
+
+Poprzednie wersje (pre-1.0.0) plugin przechowywane urządzenia bezwzględna plik lokalizacja
w `fullPath` Właściwość `Entry` obiektów. Te ścieżki zazwyczaj będzie wyglądać
+
+    /var/mobile/Applications/<application UUID>/Documents/path/to/file  (iOS)
+    /storage/emulated/0/path/to/file                                    (Android)
+    
+
+Te ścieżki również zostały zwrócone przez `toURL()` Metoda `Entry` obiektów.
+
+Z v1.0.0 `fullPath` atrybut jest ścieżką do pliku, *względem katalogu głównego systemu
plików HTML*. Tak, powyżej ścieżki będzie teraz zarówno reprezentowana przez `FileEntry`
obiekt z `fullPath` z
+
+    /path/to/file
+    
+
+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.
+
+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.
+
+W v1.1.0 wartość zwracana z `toURL()` został zmieniony (patrz \[CB-6394\] (https://issues.apache.org/jira/browse/CB-6394))
zwraca adres URL absolutnej "file://". wszędzie tam, gdzie jest to możliwe. Aby zapewnić
' cdvfile:'-URL można użyć `toInternalURL()` teraz. Ta metoda zwróci teraz adresy URL
plików formularza
+
+    cdvfile://localhost/persistent/path/to/file
+    
+
+który służy do jednoznacznej identyfikacji pliku.
+
+## Wykaz kodów błędów i ich znaczenie
+
+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
+
+## Konfigurowanie wtyczka (opcjonalny)
+
+Zestaw dostępnych plików może być skonfigurowany na platformie. Zarówno iOS i Android
<preference> uchwyt w `config.xml` które nazwy plików do instalacji. Domyślnie włączone
są wszystkie korzenie systemu plików.
+
+    <preference name="iosExtraFilesystems" value="library,library-nosync,documents,documents-nosync,cache,bundle,root"
/>
+    <preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root"
/>
+    
+
+### 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
+
+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
+
+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

http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/9f937b71/doc/pl/plugins.md
----------------------------------------------------------------------
diff --git a/doc/pl/plugins.md b/doc/pl/plugins.md
new file mode 100644
index 0000000..a1f9169
--- /dev/null
+++ b/doc/pl/plugins.md
@@ -0,0 +1,124 @@
+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# Uwagi dla programistów wtyczki
+
+Te notatki są przeznaczone przede wszystkim dla Androida i iOS programistów, którzy chcieli
pisac pluginy które interfejs z systemu plików za pomocą wtyczki pliku.
+
+## Praca z Cordova pliku system adresów URL
+
+Od wersji 1.0.0, ten plugin jest używane adresy URL z `cdvfile` system do komunikacji przez
most, a nie narażać urządzenia raw ścieżki systemu plików JavaScript.
+
+Na stronie JavaScript oznacza to, że FileEntry i DirectoryEntry obiekty mają fullPath atrybut,
który jest głównym systemie plików HTML. Jeśli twój plugin JavaScript API akceptuje
obiektu DirectoryEntry lub FileEntry, należy zadzwonić `.toURL()` na obiekt przed przekazaniem
przez most do kodu macierzystego.
+
+### Konwersja cdvfile: / / URL do ścieżki fileystem
+
+Wtyczek, które trzeba pisać do systemu plików może chcesz przekonwertować odebranych
plików systemu adres URL lokalizacji rzeczywistych plików. Istnieje wiele sposobów działania,
od macierzystego platformy.
+
+Ważne jest, aby pamiętać, że nie wszystkie `cdvfile://` adresy URL są można zmapować
na prawdziwe akta urządzeniu. Niektóre adresy URL może odnosić się do aktywów na urządzeniu,
które nie są reprezentowane przez pliki, lub nawet może odnosić się do zasobów zdalnych.
Z powodu tych możliwości wtyczki należy zawsze sprawdzić, czy się znaczących wyników
wstecz, podczas próby konwersji adresów URL do ścieżki.
+
+#### Android
+
+Na Android, najprostsza metoda konwersji `cdvfile://` URL do ścieżki systemu plików jest
użycie `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`jest kilka metod, które
mogą obsługiwać `cdvfile://` adresów URL:
+
+    // webView is a member of the Plugin class
+    CordovaResourceApi resourceApi = webView.getResourceApi();
+    
+    // Obtain a file:/// URL representing this file on the device,
+    // or the same URL unchanged if it cannot be mapped to a file
+    Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));
+    
+
+Jest również możliwe, aby korzystać z wtyczki pliku bezpośrednio:
+
+    import org.apache.cordova.file.FileUtils;
+    import org.apache.cordova.file.FileSystem;
+    import java.net.MalformedURLException;
+    
+    // Get the File plugin from the plugin manager
+    FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin("File");
+    
+    // Given a URL, get a path for it
+    try {
+        String path = filePlugin.filesystemPathForURL(cdvfileURL);
+    } catch (MalformedURLException e) {
+        // The filesystem url wasn't recognized
+    }
+    
+
+Do przeliczenia ścieżki do `cdvfile://` adres URL:
+
+    import org.apache.cordova.file.LocalFilesystemURL;
+    
+    // Get a LocalFilesystemURL object for a device path,
+    // or null if it cannot be represented as a cdvfile URL.
+    LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);
+    // Get the string representation of the URL object
+    String cdvfileURL = url.toString();
+    
+
+Jeśli twój plugin tworzy plik, i chcesz zwraca obiekt FileEntry dla niego, użyj pliku
plugin:
+
+    // Return a JSON structure suitable for returning to JavaScript,
+    // or null if this file is not representable as a cdvfile URL.
+    JSONObject entry = filePlugin.getEntryForFile(file);
+    
+
+#### iOS
+
+Cordova na iOS nie korzystać z tego samego `CordovaResourceApi` koncepcji jak Android. Na
iOS należy użyć pliku plugin do konwersji między adresach URL i ścieżkach plików.
+
+    // Get a CDVFilesystem URL object from a URL string
+    CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];
+    // Get a path for the URL object, or nil if it cannot be mapped to a file
+    NSString* path = [filePlugin filesystemPathForURL:url];
+    
+    
+    // Get a CDVFilesystem URL object for a device path, or
+    // nil if it cannot be represented as a cdvfile URL.
+    CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];
+    // Get the string representation of the URL object
+    NSString* cdvfileURL = [url absoluteString];
+    
+
+Jeśli twój plugin tworzy plik, i chcesz zwraca obiekt FileEntry dla niego, użyj pliku
plugin:
+
+    // Get a CDVFilesystem URL object for a device path, or
+    // nil if it cannot be represented as a cdvfile URL.
+    CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];
+    // Get a structure to return to JavaScript
+    NSDictionary* entry = [filePlugin makeEntryForLocalURL:url]
+    
+
+#### JavaScript
+
+W JavaScript, aby uzyskać `cdvfile://` adres URL z obiektu FileEntry lub DirectoryEntry,
wystarczy zadzwonić `.toURL()` na to:
+
+    var cdvfileURL = entry.toURL();
+    
+
+W plugin obsługi odpowiedzi do przeliczenia strukturę FileEntry wrócił do rzeczywistego
obiektu wejścia, kod obsługi należy importować pliku plugin i utworzyć nowy obiekt:
+
+    // create appropriate Entry object
+    var entry;
+    if (entryStruct.isDirectory) {
+        entry = new DirectoryEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));
+    } else {
+        entry = new FileEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/9f937b71/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
new file mode 100644
index 0000000..aa910fa
--- /dev/null
+++ b/doc/zh/index.md
@@ -0,0 +1,201 @@
+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# org.apache.cordova.file
+
+這個外掛程式提供了[HTML5 檔案系統 API][1]。 用法,請參閱 HTML5 岩石[檔案系統條][2]關於這個問題。
其他存儲選項的概述,請參閱科爾多瓦的[存儲指南][3].
+
+ [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
+
+## 安裝
+
+    cordova plugin add org.apache.cordova.file
+    
+
+## 支援的平臺
+
+*   亞馬遜火 OS
+*   Android 系統
+*   黑莓 10
+*   iOS
+*   Windows Phone 7 和 8 *
+*   Windows 8 *
+*   火狐瀏覽器作業系統
+
+**這些平臺不支援 `FileReader.readAsArrayBuffer` ,也不 `FileWriter.write(blob)`
.*
+
+## 存儲檔的位置
+
+自 v1.2.0,提供重要的檔案系統目錄的 Url。 每個 URL 是在表單*file:///path/to/spot/*,和可以轉換為
`DirectoryEntry` 使用`window.resolveLocalFileSystemURL()`.
+
+`cordova.file.applicationDirectory`-唯讀目錄應用程式的安裝位置。(*iOS* *Android*)
+
+`cordova.file.applicationStorageDirectory`-應用程式的私有可寫存儲的根。(*iOS*
*Android*)
+
+`cordova.file.dataDirectory`-在何處放置應用程式特定的資料檔案。(*iOS* *Android*)
+
+`cordova.file.cacheDirectory`-緩存應該生存重新開機應用程式的檔。應用程式不應依賴
OS,以刪除檔在這裡。(*iOS* *Android*)
+
+`cordova.file.externalApplicationStorageDirectory`-應用程式外部存儲上的空間。(*iOS*
*Android*)
+
+`cordova.file.externalDataDirectory`-要把外部存儲的特定于應用程式資料檔案的位置。(*Android*)
+
+`cordova.file.externalCacheDirectory`外部存儲的應用程式緩存。(*Android*)
+
+`cordova.file.externalRootDirectory`-外部存儲 (SD 卡) 根。(*Android*)
+
+`cordova.file.tempDirectory`-將 OS 可以清除時的 temp 目錄。(*iOS*)
+
+`cordova.file.syncedDataDirectory`-持有應同步 (例如到 iCloud) 的應用程式特定的檔。(*iOS*)
+
+`cordova.file.documentsDirectory`-檔專用的應用程式,但這是對其他 applciations
(例如 Office 檔) 有意義。(*iOS*)
+
+## Android 的怪癖
+
+### Android 的永久存儲位置
+
+有多個存儲持久性 Android 設備上的檔的有效位置。 請參閱[此頁][4]為廣泛地討論的各種可能性。
+
+ [4]: http://developer.android.com/guide/topics/data/data-storage.html
+
+以前版本的外掛程式會選擇在啟動時,基於是否該設備聲稱 SD 卡 (或等效存儲分區)
安裝臨時和永久檔的位置。 如果被掛載 SD 卡,或者如果一個大的內部存儲分區是可用
(如 Nexus 的設備上,) 然後持久性檔將存儲在該空間的根。 這就意味著所有的科爾多瓦應用可以看到所有可用的檔在卡上。
+
+如果 SD 卡不是可用的然後以前的版本會將資料存儲在下/資料/資料 /<packageid>其中隔離應用程式從彼此,但仍然可能會導致使用者之間共用資料。
+
+現在可以選擇是否要將檔存儲在內部檔存儲位置,或使用以前的邏輯,在您的應用程式的
config.xml 檔首選項。 若要執行此操作,請將這兩行之一添加到 config.xml:
+
+    <preference name="AndroidPersistentFileLocation" value="Internal" />
+    
+    <preference name="AndroidPersistentFileLocation" value="Compatibility" />
+    
+
+如果這條線,沒有檔外掛程式將作為預設值使用"相容性"。如果首選項標記是存在,並不是這些值之一,應用程式將無法啟動。
+
+如果您的應用程式先前已經運送到使用者,使用較舊的 (預 1.0) 的這個外掛程式版本和已存儲的檔中的持久性的檔案系統,然後您應該設置的首選項的"相容性"。
切換到"內部"的位置就意味著現有使用者升級他們的應用程式可能無法訪問他們以前存儲的檔,他們的設備。
+
+如果您的應用程式是新的或以前從未有持久性檔案系統中存儲的檔,然後通常會建議的"內部"的設置。
+
+## iOS 的怪癖
+
+*   `FileReader.readAsText(blob, encoding)` 
+    *   `encoding`參數不受支援,和 utf-8 編碼總是有效。
+
+### iOS 的持久性存儲位置
+
+有兩個有效位置來存儲持久性的 iOS 設備上的檔: 檔目錄和庫目錄。
以前版本的外掛程式只過持久性檔存儲在檔目錄中。 這有副作用 —
— 使所有的應用程式的檔可見在 iTunes 中,往往是意料之外的特別是為處理大量小檔的應用程式,而不是生產用於出口,是預期的目的的目錄的完整的檔。
+
+現在可以選擇是否要將檔存儲在檔或庫目錄,與您的應用程式的 config.xml
檔中的偏好。 若要執行此操作,請將這兩行之一添加到 config.xml:
+
+    <preference name="iosPersistentFileLocation" value="Library" />
+    
+    <preference name="iosPersistentFileLocation" value="Compatibility" />
+    
+
+如果這條線,沒有檔外掛程式將作為預設值使用"相容性"。如果首選項標記是存在,並不是這些值之一,應用程式將無法啟動。
+
+如果您的應用程式先前已經運送到使用者,使用較舊的 (預 1.0) 的這個外掛程式版本和已存儲的檔中的持久性的檔案系統,然後您應該設置的首選項的"相容性"。
切換到"庫"的位置意味著升級他們的應用程式的現有使用者將無法訪問他們以前存儲的檔。
+
+如果您的應用程式是新的或以前從未有持久性檔案系統中存儲的檔,然後通常會建議"的庫"設置。
+
+### 火狐瀏覽器作業系統的怪癖
+
+檔案系統 API 本機作業系統不支援火狐瀏覽器,在 indexedDB shim 作為實現的。
+
+*   不會失敗時刪除非空的目錄
+*   不支援用中繼資料的目錄
+*   不支援 `requestAllFileSystems` 和 `resolveLocalFileSystemURI` 的方法
+*   方法 `copyTo` 和 `moveTo` 不支援目錄
+
+## 升級說明
+
+在此外掛程式 v1.0.0 `FileEntry` 和 `DirectoryEntry` 結構已經更改,以更符合已發佈的規範。
+
+以前 (pre-1.0.0) 版本的外掛程式存儲的設備-絕對-檔-位置在 `fullPath`
屬性的 `Entry` 物件。這些路徑通常看起來就像
+
+    /var/mobile/Applications/<application UUID>/Documents/path/to/file  (iOS)
+    /storage/emulated/0/path/to/file                                    (Android)
+    
+
+這些路徑還返回的 `toURL()` 方法的 `Entry` 物件。
+
+與 v1.0.0, `fullPath` 屬性是對該檔*的 HTML 檔案系統根目錄的相對*路徑。
因此,上述路徑會現在兩者都由表示 `FileEntry` 物件與 `fullPath` 的
+
+    /path/to/file
+    
+
+如果您的應用程式與設備-絕對路徑,和你以前檢索到這些路徑通過
`fullPath` 屬性的 `Entry` 物件,然後你應該更新您的代碼以使用 `entry.toURL()`
相反。
+
+為向後相容性, `resolveLocalFileSystemURL()` 方法將接受絕對設備的路徑,並將返回
`Entry` 對應于它,只要該檔存在的臨時或永久性的檔案系統內的物件。
+
+這特別是一直帶有檔案傳輸外掛程式,以前使用過的設備絕對路徑的問題
(和仍然可以接受他們)。 它已更新為與檔案系統的 Url,所以取代正常工作
`entry.fullPath` 與 `entry.toURL()` 應解決獲取該外掛程式來處理檔的設備上的任何問題。
+
+V1.1.0 的傳回值中的 `toURL()` 已更改 (請參見 \[CB-6394\] (HTTPs://issues.apache.org/jira/browse/CB-6394))
返回一個絕對 'file:// URL。 在可能的情況。 為確保 ' cdvfile:'-您可以使用的
URL `toInternalURL()` 現在。 現在,此方法將返回該表單的檔案系統 Url
+
+    cdvfile://localhost/persistent/path/to/file
+    
+
+它可以用於唯一地標識該檔。
+
+## 錯誤代碼和含義的清單
+
+錯誤引發時,將使用以下代碼之一。
+
+*   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
+
+## 配置的外掛程式 (可選)
+
+可用的檔案系統的一組可配置的每個平臺。IOS 和 android 系統識別 <preference>
在中添加標籤 `config.xml` 的名字要安裝的檔案系統。預設情況下,啟用所有檔案系統根。
+
+    <preference name="iosExtraFilesystems" value="library,library-nosync,documents,documents-nosync,cache,bundle,root"
/>
+    <preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root"
/>
+    
+
+### Android 系統
+
+*   檔: 應用程式的內部檔存儲目錄
+*   檔外部: 應用程式的外部檔存儲目錄
+*   sdcard: 全球外部檔存儲目錄 (如果安裝了一個,這是 SD 卡的根目錄)。
您必須具有 `android.permission.WRITE_EXTERNAL_STORAGE` 使用此許可權。
+*   快取記憶體: 應用程式的內部緩存目錄
+*   外部快取記憶體: 應用程式的外部快取記憶體目錄
+*   根: 整個設備的檔案系統
+
+Android 還支援名為"檔",它表示"檔的"檔案系統中的子目錄"/ 檔 /"特別的檔案系統。
+
+### iOS
+
+*   圖書館: 應用程式的庫目錄
+*   文檔: 應用程式的檔目錄
+*   快取記憶體: 應用程式的緩存目錄
+*   束: 束應用程式的 ;應用程式本身 (唯讀) 的磁片上的位置
+*   根: 整個設備的檔案系統
+
+預設情況下,圖書館和檔目錄可以同步到 iCloud。 你也可以要求兩個附加檔案系統、"圖書館-非同步"和"文檔-nosync",代表特別的非同步的目錄內的庫或檔的檔案系統。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/9f937b71/doc/zh/plugins.md
----------------------------------------------------------------------
diff --git a/doc/zh/plugins.md b/doc/zh/plugins.md
new file mode 100644
index 0000000..462fb06
--- /dev/null
+++ b/doc/zh/plugins.md
@@ -0,0 +1,124 @@
+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# 外掛程式開發人員須知
+
+這些筆記主要針對 Android 和 iOS 開發者想要使用的檔案系統使用的檔外掛程式編寫外掛程式哪個介面。
+
+## 工作與科爾多瓦檔案系統 Url
+
+1.0.0 版以來,這個外掛程式用了 Url 與 `cdvfile` 在橋樑,為所有的通信計畫,而不是暴露
JavaScript 原始設備的檔案系統路徑。
+
+在 JavaScript 方面,這意味著 FileEntry 和 DirectoryEntry 的物件具有一個完整路徑屬性是相對於
HTML 檔案系統的根目錄。 如果你的外掛程式的 JavaScript API 接受 FileEntry
或 DirectoryEntry 的物件,則應調用 `.toURL()` 對該物件之前將它在橋上傳遞給本機代碼。
+
+### 轉換 cdvfile: / / fileystem 的路徑的 Url
+
+需要寫入到檔案系統的外掛程式可能會想要將收到的檔案系統的 URL
轉換為實際的檔案系統位置。有多種方法做這個,根據本機平臺。
+
+它是重要的是要記住,不是所有 `cdvfile://` 的 Url 均可映射到設備上的實際檔。
某些 Url 可以引用在設備上不是由檔,或甚至可以引用遠端資源的資產。
由於這些可能性,外掛程式應始終測試是否回試圖將 Url 轉換成路徑時,他們得到有意義的結果。
+
+#### Android 系統
+
+在 android 系統,最簡單的方法來轉換 `cdvfile://` 檔案系統路徑的 URL 是使用
`org.apache.cordova.CordovaResourceApi` 。 `CordovaResourceApi`有幾種方法,可處理
`cdvfile://` 的 Url:
+
+    // webView is a member of the Plugin class
+    CordovaResourceApi resourceApi = webView.getResourceApi();
+    
+    // Obtain a file:/// URL representing this file on the device,
+    // or the same URL unchanged if it cannot be mapped to a file
+    Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));
+    
+
+它也是可以直接使用檔外掛程式:
+
+    import org.apache.cordova.file.FileUtils;
+    import org.apache.cordova.file.FileSystem;
+    import java.net.MalformedURLException;
+    
+    // Get the File plugin from the plugin manager
+    FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin("File");
+    
+    // Given a URL, get a path for it
+    try {
+        String path = filePlugin.filesystemPathForURL(cdvfileURL);
+    } catch (MalformedURLException e) {
+        // The filesystem url wasn't recognized
+    }
+    
+
+要轉換的路徑從 `cdvfile://` 的 URL:
+
+    import org.apache.cordova.file.LocalFilesystemURL;
+    
+    // Get a LocalFilesystemURL object for a device path,
+    // or null if it cannot be represented as a cdvfile URL.
+    LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);
+    // Get the string representation of the URL object
+    String cdvfileURL = url.toString();
+    
+
+如果你的外掛程式創建一個檔,並且您想要為它返回一個 FileEntry 物件,使用該檔外掛程式:
+
+    // Return a JSON structure suitable for returning to JavaScript,
+    // or null if this file is not representable as a cdvfile URL.
+    JSONObject entry = filePlugin.getEntryForFile(file);
+    
+
+#### iOS
+
+科爾多瓦在 iOS 上的不使用相同 `CordovaResourceApi` 作為 android 系統的概念。在
iOS,應使用檔外掛程式的 Url 和檔案系統路徑之間進行轉換。
+
+    // Get a CDVFilesystem URL object from a URL string
+    CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];
+    // Get a path for the URL object, or nil if it cannot be mapped to a file
+    NSString* path = [filePlugin filesystemPathForURL:url];
+    
+    
+    // Get a CDVFilesystem URL object for a device path, or
+    // nil if it cannot be represented as a cdvfile URL.
+    CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];
+    // Get the string representation of the URL object
+    NSString* cdvfileURL = [url absoluteString];
+    
+
+如果你的外掛程式創建一個檔,並且您想要為它返回一個 FileEntry 物件,使用該檔外掛程式:
+
+    // Get a CDVFilesystem URL object for a device path, or
+    // nil if it cannot be represented as a cdvfile URL.
+    CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];
+    // Get a structure to return to JavaScript
+    NSDictionary* entry = [filePlugin makeEntryForLocalURL:url]
+    
+
+#### JavaScript
+
+在 JavaScript 中,得到 `cdvfile://` URL 從 FileEntry 或 DirectoryEntry 的物件,只需調用
`.toURL()` 對它:
+
+    var cdvfileURL = entry.toURL();
+    
+
+在外掛程式回應處理常式,將從返回的 FileEntry 結構轉換為實際的輸入物件,您的處理常式代碼應該導入的檔外掛程式並創建一個新的物件:
+
+    // create appropriate Entry object
+    var entry;
+    if (entryStruct.isDirectory) {
+        entry = new DirectoryEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));
+    } else {
+        entry = new FileEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));
+    }
\ No newline at end of file


Mime
View raw message