uni-app

uni-app

uni-app 跨平台開發框架的全面技能參考指南

10星標
3分支
更新於 2026/8/24
SKILL.md
唯讀
名稱
uni-app
描述

uni-app 跨平台開發框架的全面技能參考指南

本技能基於 uni-app 官方文件建立,生成時間為 2026-01-30。

uni-app 是一個基於 Vue.js 的跨平台開發框架,可用於開發執行在 iOS、Android、HarmonyOS、Web(響應式)以及各種小程式平台(微信/支付寶/百度/抖音/飛書/QQ/快手/釘釘/淘寶/京東/小紅書)的應用程式。

核心(Core)

主題 說明 參考文件
核心框架 專案結構、平台支援、條件編譯 core-framework
檢視元件 view, scroll-view, swiper, movable-area, cover-view core-view-components
表單元件 input, textarea, picker, checkbox, radio, switch, slider core-form-components

功能特性(Features)

UI 元件

主題 說明 參考文件
媒體元件 image, video, camera, live-player, map feature-media-components
導覽 navigator、路由、頁面導覽 feature-navigation
UI 反饋 toast、modal、loading、action sheet、下拉刷新 feature-ui-feedback

API

主題 說明 參考文件
網路 HTTP 請求、檔案上傳/下載、WebSocket feature-network
儲存 本地儲存、檔案系統、快取 feature-storage
系統資訊 裝置資訊、網路狀態、螢幕、震動 feature-system-info
檔案操作 圖片/影片選擇、檔案系統操作 feature-file-operations
定位 地理定位、地圖元件、地址選擇 feature-location
生命週期 App 與頁面的生命週期 Hook feature-lifecycle

設定(Configuration)

主題 說明 參考文件
pages.json 頁面路由、tab bar、全域樣式、分包設定 config-pages
manifest.json App 設定、權限設定、平台相關設定 config-manifest

平台支援(Platform Support)

平台 支援程度
iOS App 完整支援
Android App 完整支援
HarmonyOS Next 完整支援
H5/Web 完整支援
微信小程式 完整支援
支付寶小程式 完整支援
百度智慧小程式 完整支援
抖音小程式 完整支援
QQ 小程式 完整支援
快手小程式 完整支援
飛書小程式 完整支援
京東小程式 完整支援
鴻蒙原子化服務 (Meta Service) 完整支援

重要概念(Key Concepts)

條件編譯

使用特殊的註解語法撰寫特定平台的程式碼:

<!-- #ifdef APP-PLUS -->
<view>僅限 App</view>
<!-- #endif -->

<!-- #ifdef MP-WEIXIN -->
<view>僅限微信</view>
<!-- #endif -->

API Promise 支援

當未傳入 callback 時,大部分 uni-app API 都支援 Promise 呼叫方式:

const res = await uni.request({ url: 'https://api.example.com' })

跨平台最佳實踐

  1. 優先使用 uni-app 內建元件與 API,避免使用特定平台的專屬寫法
  2. 使用條件編譯處理平台專屬功能
  3. 在所有目標平台上進行測試
  4. 使用 rpx 進行響應式版面配置
  5. 在 manifest.json 中處理各平台的差異設定