react-native-kookit 0.2.4 → 0.2.6

package/FTP_FILE_LIST_ENHANCEMENT.md

@@ -0,0 +1,186 @@
+# FTP 文件列表功能增强
+
+本文档描述了对 FTP 客户端示例应用中文件列表功能的增强。
+
+## 新增功能
+
+### 🗂️ 增强的文件列表显示
+
+**文件信息显示：**
+
+- 📁 文件夹图标 / 📄 文件图标
+- 文件/文件夹名称
+- 文件大小（字节）
+- 最后修改时间
+- 文件权限信息
+
+**交互功能：**
+
+- 点击文件夹：直接进入该文件夹
+- 点击文件：显示文件操作菜单
+- 点击菜单按钮(⋮)：显示详细操作选项
+
+### 📂 目录导航功能
+
+**导航按钮：**
+
+- **Refresh（刷新）**: 重新加载当前目录的文件列表
+- **Up（向上）**: 返回父目录
+- **Root（根目录）**: 直接跳转到根目录
+- **New Folder（新建文件夹）**: 创建新文件夹
+
+**当前路径显示：**
+
+- 实时显示当前所在的目录路径
+- 便于用户了解当前位置
+
+### 📄 文件操作菜单
+
+**对于文件：**
+
+- **Download（下载）**: 下载文件到本地临时目录
+- **Delete（删除）**: 删除远程服务器上的文件
+- **Cancel（取消）**: 关闭操作菜单
+
+**对于文件夹：**
+
+- **Open Directory（打开目录）**: 进入该文件夹
+- **Delete（删除）**: 删除整个文件夹及其内容
+- **Cancel（取消）**: 关闭操作菜单
+
+### 📁 新建文件夹功能
+
+**操作流程：**
+
+1. 点击 "New Folder" 按钮
+2. 在弹出的对话框中输入文件夹名称
+3. 点击 "Create" 创建文件夹
+4. 自动刷新文件列表显示新创建的文件夹
+
+### 🔒 安全确认
+
+**删除确认：**
+
+- 删除任何文件或文件夹前都会弹出确认对话框
+- 防止误删除重要数据
+- 显示将要删除的项目名称
+
+## 用户界面改进
+
+### 📱 响应式设计
+
+**文件列表项：**
+
+- 更大的点击区域，便于触摸操作
+- 清晰的视觉层次，信息一目了然
+- 文件夹和文件使用不同的颜色和样式区分
+
+**模态对话框：**
+
+- 半透明背景，专注于当前操作
+- 居中显示，适合各种屏幕尺寸
+- 清晰的按钮布局，操作直观
+
+### 🎨 视觉优化
+
+**图标系统：**
+
+- 📁 文件夹图标：蓝色文本，便于识别
+- 📄 文件图标：常规颜色
+- ⋮ 菜单图标：灰色，表示更多操作
+
+**信息层次：**
+
+- 文件名：主要信息，字体较大
+- 文件大小：次要信息，字体中等
+- 修改时间：辅助信息，字体较小，灰色
+
+## 操作流程示例
+
+### 典型文件浏览流程
+
+1. **连接 FTP 服务器**
+
+   ```
+   创建客户端 → 输入连接信息 → 点击连接
+   ```
+
+2. **浏览文件**
+
+   ```
+   查看文件列表 → 点击文件夹进入 → 查看文件详情
+   ```
+
+3. **文件操作**
+
+   ```
+   选择文件 → 选择操作（下载/删除） → 确认操作
+   ```
+
+4. **目录管理**
+   ```
+   新建文件夹 → 输入名称 → 创建 → 查看结果
+   ```
+
+### 下载文件示例
+
+```typescript
+// 用户点击文件 → 选择下载 → 自动执行下载
+const downloadFile = async (file: any) => {
+  const localPath = `/tmp/${file.name}`;
+  await ftpClient.download(file.name, localPath);
+  // 显示成功消息和本地路径
+};
+```
+
+### 创建文件夹示例
+
+```typescript
+// 用户输入文件夹名 → 点击创建 → 自动刷新列表
+const createFolder = async () => {
+  await ftpClient.createDirectory(newFolderName);
+  await listFiles(); // 刷新文件列表
+};
+```
+
+## 错误处理
+
+### 网络错误
+
+- 连接超时：显示友好的错误消息
+- 认证失败：提示检查用户名和密码
+- 权限不足：显示权限相关的错误信息
+
+### 文件操作错误
+
+- 下载失败：显示具体的失败原因
+- 删除失败：可能是权限问题或文件正在使用
+- 创建文件夹失败：可能是名称冲突或权限不足
+
+### 用户输入错误
+
+- 空文件夹名：禁用创建按钮
+- 无效字符：提示输入有效的文件夹名称
+
+## 技术实现要点
+
+### 状态管理
+
+- `files`: 当前目录的文件列表
+- `selectedFile`: 当前选中的文件
+- `showFileModal`: 文件操作模态框显示状态
+- `showCreateFolder`: 创建文件夹模态框显示状态
+
+### 事件处理
+
+- 文件点击：区分文件和文件夹的不同处理逻辑
+- 模态框管理：正确的显示和隐藏逻辑
+- 异步操作：proper async/await 处理和错误捕获
+
+### 用户体验优化
+
+- 操作反馈：每个操作都有相应的日志记录
+- 进度显示：下载和上传操作显示进度
+- 状态保持：操作完成后自动刷新相关状态
+
+这些增强功能使得 FTP 客户端示例应用更加实用和用户友好，提供了完整的文件管理体验。

package/android/src/main/java/expo/modules/kookit/FtpClient.kt

@@ -39,6 +39,8 @@ class FtpClient {
     private var config: FtpConnectionConfig? = null
     private var useUtf8 = false
     
+    fun isConnected(): Boolean = isConnected
+    
     @Throws(Exception::class)
     suspend fun connect(config: FtpConnectionConfig) = withContext(Dispatchers.IO) {
         this@FtpClient.config = config

package/android/src/main/java/expo/modules/kookit/ReactNativeKookitModule.kt

@@ -17,6 +17,7 @@ class ReactNativeKookitModule : Module() {
   private var audioManager: AudioManager? = null
   private var originalStreamVolume: Int = 0
   private var ftpClient: FtpClient? = null
+  private val ftpClients = mutableMapOf<String, FtpClient>()
   private val moduleScope = CoroutineScope(Dispatchers.Main + SupervisorJob())
 
   // Each module class must implement the definition function. The definition consists of components
@@ -82,6 +83,257 @@ class ReactNativeKookitModule : Module() {
       }
     }
 
+    // New FTP Client Management Functions
+    AsyncFunction("createFtpClient") { clientId: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          if (ftpClients.containsKey(clientId)) {
+            promise.reject("FTP_CLIENT_EXISTS", "FTP client with ID '$clientId' already exists", null)
+            return@launch
+          }
+          
+          val client = FtpClient()
+          ftpClients[clientId] = client
+          promise.resolve(mapOf("clientId" to clientId))
+        } catch (e: Exception) {
+          promise.reject("FTP_CREATE_CLIENT_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("disposeFtpClient") { clientId: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+          if (client != null) {
+            client.disconnect()
+            ftpClients.remove(clientId)
+          }
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_DISPOSE_CLIENT_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("getFtpClientStatus") { clientId: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+          val status = mapOf(
+            "exists" to (client != null),
+            "connected" to (client?.isConnected() ?: false)
+          )
+          promise.resolve(status)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_STATUS_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("listFtpClients") { promise: Promise ->
+      moduleScope.launch {
+        try {
+          val clients = mutableMapOf<String, Map<String, Any>>()
+          ftpClients.forEach { (id, client) ->
+            clients[id] = mapOf("connected" to client.isConnected())
+          }
+          val result = mapOf(
+            "clients" to clients,
+            "count" to ftpClients.size
+          )
+          promise.resolve(result)
+        } catch (e: Exception) {
+          promise.reject("FTP_LIST_CLIENTS_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientConnect") { clientId: String, config: Map<String, Any>, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          
+          val ftpConfig = FtpConnectionConfig(
+            host = config["host"] as String,
+            port = (config["port"] as? Double)?.toInt() ?: 21,
+            username = config["username"] as String,
+            password = config["password"] as String,
+            passive = config["passive"] as? Boolean ?: true,
+            timeout = (config["timeout"] as? Double)?.toInt() ?: 30000
+          )
+          
+          client.connect(ftpConfig)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_CONNECT_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientDisconnect") { clientId: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          client.disconnect()
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_DISCONNECT_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientList") { clientId: String, path: String?, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          
+          val files = client.listFiles(path)
+          val result = files.map { file ->
+            mapOf(
+              "name" to file.name,
+              "isDirectory" to file.isDirectory,
+              "size" to file.size,
+              "lastModified" to file.lastModified,
+              "permissions" to file.permissions
+            )
+          }
+          promise.resolve(result)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_LIST_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientDownload") { clientId: String, remotePath: String, localPath: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          
+          val listener = object : FtpProgressListener {
+            override fun onProgress(transferred: Long, total: Long) {
+              val percentage = if (total > 0) (transferred * 100 / total).toInt() else 0
+              sendEvent("onFtpProgress", mapOf(
+                "clientId" to clientId,
+                "transferred" to transferred,
+                "total" to total,
+                "percentage" to percentage
+              ))
+            }
+            
+            override fun onComplete() {
+              sendEvent("onFtpComplete", mapOf("clientId" to clientId))
+            }
+            
+            override fun onError(error: String) {
+              sendEvent("onFtpError", mapOf(
+                "clientId" to clientId,
+                "error" to error
+              ))
+            }
+          }
+          
+          client.downloadFile(remotePath, localPath, listener)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_DOWNLOAD_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientUpload") { clientId: String, localPath: String, remotePath: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          
+          val listener = object : FtpProgressListener {
+            override fun onProgress(transferred: Long, total: Long) {
+              val percentage = if (total > 0) (transferred * 100 / total).toInt() else 0
+              sendEvent("onFtpProgress", mapOf(
+                "clientId" to clientId,
+                "transferred" to transferred,
+                "total" to total,
+                "percentage" to percentage
+              ))
+            }
+            
+            override fun onComplete() {
+              sendEvent("onFtpComplete", mapOf("clientId" to clientId))
+            }
+            
+            override fun onError(error: String) {
+              sendEvent("onFtpError", mapOf(
+                "clientId" to clientId,
+                "error" to error
+              ))
+            }
+          }
+          
+          client.uploadFile(localPath, remotePath, listener)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_UPLOAD_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientDelete") { clientId: String, remotePath: String, isDirectory: Boolean?, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          client.deleteFile(remotePath, isDirectory ?: false)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_DELETE_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientCreateDirectory") { clientId: String, remotePath: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          client.createDirectory(remotePath)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_CREATE_DIR_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientChangeDirectory") { clientId: String, remotePath: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          client.changeDirectory(remotePath)
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_CHANGE_DIR_ERROR", e.message, e)
+        }
+      }
+    }
+
+    AsyncFunction("ftpClientGetCurrentDirectory") { clientId: String, promise: Promise ->
+      moduleScope.launch {
+        try {
+          val client = ftpClients[clientId]
+            ?: throw Exception("FTP client with ID '$clientId' not found")
+          val currentDir = client.getCurrentDirectory()
+          promise.resolve(currentDir)
+        } catch (e: Exception) {
+          promise.reject("FTP_CLIENT_PWD_ERROR", e.message, e)
+        }
+      }
+    }
+
     AsyncFunction("ftpDisconnect") { promise: Promise ->
       moduleScope.launch {
         try {

package/build/FtpClient.d.ts

@@ -0,0 +1,97 @@
+import type { FtpConnectionConfig, FtpFileInfo } from "./ReactNativeKookit.types";
+export interface FtpClientEventHandlers {
+    onProgress?: (progress: {
+        transferred: number;
+        total: number;
+        percentage: number;
+    }) => void;
+    onComplete?: () => void;
+    onError?: (error: Error) => void;
+}
+export declare class FtpClient {
+    private clientId;
+    private isDisposed;
+    private eventHandlers;
+    private eventSubscriptions;
+    constructor(clientId?: string);
+    private setupEventListeners;
+    /**
+     * Set event handlers
+     */
+    setEventHandlers(handlers: FtpClientEventHandlers): void;
+    /**
+     * Initialize the FTP client instance
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect to the FTP server
+     */
+    connect(config: FtpConnectionConfig): Promise<void>;
+    /**
+     * Disconnect from the FTP server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * List files in the specified directory
+     */
+    list(path?: string): Promise<FtpFileInfo[]>;
+    /**
+     * Download a file from the remote server
+     */
+    download(remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Upload a file to the remote server
+     */
+    upload(localPath: string, remotePath: string): Promise<void>;
+    /**
+     * Delete a file or directory on the remote server
+     */
+    delete(remotePath: string, isDirectory?: boolean): Promise<void>;
+    /**
+     * Create a directory on the remote server
+     */
+    createDirectory(remotePath: string): Promise<void>;
+    /**
+     * Change the current working directory on the remote server
+     */
+    changeDirectory(remotePath: string): Promise<void>;
+    /**
+     * Get the current working directory on the remote server
+     */
+    getCurrentDirectory(): Promise<string>;
+    /**
+     * Get client status information
+     * @returns Client status including existence and connection state
+     */
+    getStatus(): Promise<{
+        clientId: string;
+        exists: boolean;
+        connected: boolean;
+    }>;
+    /**
+     * Get the client ID
+     */
+    getClientId(): string;
+    /**
+     * Check if the client is connected
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Dispose the FTP client and clean up resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Static method to list all FTP clients
+     */
+    static listClients(): Promise<{
+        clients: Record<string, {
+            connected: boolean;
+        }>;
+        count: number;
+    }>;
+    /**
+     * Static method to create and initialize a new FTP client
+     */
+    static create(clientId?: string): Promise<FtpClient>;
+}
+//# sourceMappingURL=FtpClient.d.ts.map

package/build/FtpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FtpClient.d.ts","sourceRoot":"","sources":["../src/FtpClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAIZ,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,kBAAkB,CAAqC;gBAEnD,QAAQ,CAAC,EAAE,MAAM;IAO7B,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAIxD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQjD;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAW5C;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAUF;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAarC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAIF;;OAEG;WACU,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAK3D"}