Android FTP 客戶端實現方案匯總

主流方案

1. Apache Commons Net：標準 Java FTP 庫，Android 直接可用。

   implementation 'commons-net:commons-net:3.8.0'

   上傳/下載核心代碼：

   FTPClient ftp = new FTPClient();
   ftp.connect(host, port);
   ftp.login(user, pass);
   ftp.enterLocalPassiveMode();
   ftp.setFileType(FTP.BINARY_FILE_TYPE);
   // 上傳
   ftp.storeFile(remotePath, new FileInputStream(localFile));
   // 下載
   ftp.retrieveFile(remotePath, new FileOutputStream(localFile));
   ftp.logout(); ftp.disconnect();

2. Simple FTP Library (Android 專用)：封裝更友好、支持斷點續傳、進度回調。

   implementation 'com.github.tony19:simple-ftp:1.0.0'

3. 自行封裝 Socket 實現：不推薦，需處理協議細節、編碼、被動模式數據連接等，維護成本高。

關鍵注意點

• 網絡操作**必須在子線程**（RxJava、Coroutine、ThreadPool）。
• Android 9+ 需在 Manifest 配置 android:usesCleartextTraffic="true" 或使用 HTTPS/FTPS。
• 處理中文文件名編碼：ftp.setControlEncoding("UTF-8")。
• 權限：INTERNET、READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE（視存儲位置）。

參考資源

• Android FTP 實現教程
• Commons Net 詳細示例