Needle Engine Documentation

needle.config.json được sử dụng để cung cấp cấu hình cho các tích hợp của Needle Editor và cho các plugin của quy trình build Needle Engine.


Đường dẫn
`buildDirectory`	Đây là nơi các tệp dự án đã build được sao chép đến
`assetsDirectory`	Đây là nơi các asset tích hợp Editor sẽ được sao chép đến hoặc tạo ra (ví dụ: các tệp `.glb` được xuất từ Unity hoặc Blender)
`scriptsDirectory`	Đây là thư mục mà tích hợp Editor đang theo dõi các thay đổi mã để tạo lại các component
`codegenDirectory`	Đây là nơi tích hợp Editor xuất các tệp đã tạo.
`baseUrl`	Bắt buộc cho ví dụ như tích hợp next.js hoặc SvelteKit. Khi baseUrl được thiết lập, các đường dẫn tương đối cho codegen và bên trong các tệp sẽ sử dụng baseUrl, chứ không phải assetsDirectory. Điều này hữu ích trong các trường hợp assetDirectory không khớp với url máy chủ. Ví dụ, đường dẫn trên đĩa có thể là `"assetsDirectory": "public/assets"`, nhưng framework phục vụ các tệp từ `"baseUrl": "assets"`.
Công cụ
`build : { copy: ["myFileOrDirectory"] }`	Mảng các đường dẫn chuỗi để sao chép các tệp hoặc thư mục bổ sung vào `buildDirectory`. Chúng có thể là tuyệt đối hoặc tương đối.

Ví dụ cơ bản

{
  "buildDirectory": "dist",
  "assetsDirectory": "assets",
  "scriptsDirectory": "src/scripts",
  "codegenDirectory": "src/generated"
}

Ví dụ sao chép

{
  "buildDirectory": "dist",
  "assetsDirectory": "assets",
  "scriptsDirectory": "src/scripts",
  "codegenDirectory": "src/generated",
  "build": {
    "copy": [
      "cards"
    ]
  }
}

Ví dụ với baseUrl khác (ví dụ: SvelteKit, Next.js)

Các tệp được xuất sang static/assets nhưng framework phục vụ chúng từ /assets. Trong trường hợp này, baseUrl cần được đặt thành assets để các đường dẫn tương đối trong các tệp là chính xác.

{
  "baseUrl": "assets",
  "buildDirectory": "dist",
  "assetsDirectory": "static/assets",
  "scriptsDirectory": "src/scripts",
  "codegenDirectory": "src/generated"
}

Các liên kết liên quan

Project Structure

Trang được dịch tự động bằng AI