# uniapp-LocalHttpServer

**Repository Path**: xzhao233/uniapp-local-http-server

## Basic Information

- **Project Name**: uniapp-LocalHttpServer
- **Description**: uniapp安卓原生语言插件，用于部署简单的静态web服务器
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-03
- **Last Updated**: 2025-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本地Web服务器插件
- 该插件旨在快速在本地部署一个简单的Web服务器，用于托管静态页面资源，主要可用于web-view访问本机文件。请将页面静态资源放置在 `/static/public` (uniapp x 3.99+不适用)目录下。

- web-view内页面可通过请求以public文件夹为根目录的文件的相对路径来访问本机文件。如访问/static/public/src/test.txt文件可发送请求路径为/src/test.txt的GET请求。

## 使用方法

1. 引入插件对象：

   ```javascript
   const server = uni.requireNativePlugin("xzhao-LocalHttpServer")
   ```

2. 设置端口号（不设置时默认为 5123）：

   ```javascript
   this.port = 5123
   server.setPort(this.port)
   ```

3. 设置监听地址（不设置时默认为 `0.0.0.0`）：

   ```javascript
   server.setHostAddress("0.0.0.0")
   ```

4. 设置是否允许跨域：

   ```javascript
   server.setCORS(true)
   ```

5. 初始化服务器（需要先设置好端口和监听地址）：

   ```javascript
   server.init()
   ```

6. 启动服务器：

   ```javascript
   server.openServer()
   ```

7. 获取服务器的监听地址：

   ```javascript
   server.getHostAddress((obj) => {
       this.hostAddress = obj.hostAddress
       this.url = `http://${this.hostAddress}:${this.port}?height=400px`
   })
   ```

8. 获取本机IP地址：

   ```javascript
   server.getLocalAddress((obj) => {
       this.localAddress = obj.localAddress
   })
   ```

9. 查看网站在安卓设备中的存储路径：

   ```javascript
   server.getWebPath((obj) => {
       console.log(obj.webPath)
   })
   ```

10. 获取服务器是否正在运行：

    ```javascript
    server.isRunning((obj) => {
        this.isRunning = obj.isRunning
    })
    ```

11. 获取服务器端口号：

    ```javascript
    server.getPort((obj) => {
        this.localPort = obj.port
    })
    ```

12. 停止服务器：

    ```javascript
    server.stopServer()
    ```

13. 设置静态资源路径，该路径应位于uniapp静态路径下，默认为"static/public":

    ```javascript
    server.updateStaticPath("static/public")
    ```

14. 设置静态资源的绝对路径，默认为"/storage/emulated/0/Android/data/com.android.UniPlugin/apps/__UNI__E84C0BB/www/static/public":

    ```javascript
    server.updateAbsPath("/storage/emulated/0/Android/data/com.android.UniPlugin/apps/__UNI__E84C0BB/www/static/public")
    ```