NativeScript 是一個開源框架,讓開發者使用 JavaScript/TypeScript + CSS 構建 100% 原生 的 iOS、Android、Web 應用。不同於 Cordova/Capacitor(WebView 封裝)或 React Native(橋接原生組件),NativeScript 直接調用平台原生 API,無需編寫 Objective-C/Swift/Java/Kotlin 代碼。
| 特性 | 說明 |
|---|---|
| 100% 原生 API 訪問 | JavaScript 運行時直接映射平台 API:new android.widget.TextView()、UILabel.alloc().init() 即刻可用 |
| 零 WebView | UI 由原生佈局引擎渲染,性能、手勢、動畫、滾動體驗與純原生一致 |
| 單一代碼庫 | 業務邏輯 100% 共享,UI 可平台差異化(XML/HTML/CSS 條件編譯) |
| 標準技術棧 | TypeScript、Angular/Vue/Svelte/Solid、CSS、NPM 生態、Webpack/Vite |
| 直接使用原生庫 | 引入 .aar/.jar (Android) 或 .framework/.xcframework (iOS) 直接在 JS 中調用 |
| 熱重載 | 開發期毫秒級熱更新,保持應用狀態 |
# 1. 安裝 CLI
npm install -g @nativescript/cli
# 2. 創建項目(選擇模板:Vanilla TS / Angular / Vue / Svelte / React)
ns create my-app --template @nativescript/template-vue-ts
# 3. 運行
cd my-app
ns run android # 或 ios
ns preview # 瀏覽器預覽(Web)
<!-- main-page.xml -->
<Page loaded="onLoaded" class="page">
<ActionBar title="NativeScript Demo" />
<StackLayout class="p-20">
<Label text="點擊按鈕計數" class="h3 text-center mb-10" />
<Button text="點擊 {{ count }}" tap="onTap" class="btn btn-primary" />
<Label text="{{ message }}" class="h4 text-center mt-20" textWrap="true" />
</StackLayout>
</Page>
// main-page.ts
import { Observable } from '@nativescript/core';
export function onLoaded(args) {
const page = args.object;
page.bindingContext = new Observable({
count: 0,
message: '',
onTap() {
this.count++;
this.message = `已點擊 ${this.count} 次`;
}
});
}
<Button> → iOS: UIButton / Android: android.widget.Button<TextField> → UITextField / EditText<ListView> → UITableView / RecyclerView(虛擬化、回收複用)StackLayout (線性)、GridLayout (網格)、FlexboxLayout (Flex)、AbsoluteLayout (絕對)
/* app.css 通用 */
.ios .title { font-family: 'San Francisco'; }
.android .title { font-family: 'Roboto'; }
// Android: 打開系統相機
import { knownFolders, path } from '@nativescript/core';
const intent = new android.content.Intent(android.provider.MediaStore.ACTION_IMAGE_CAPTURE);
const file = path.join(knownFolders.temp().path, 'photo.jpg');
intent.putExtra(android.provider.MediaStore.EXTRA_OUTPUT, android.net.Uri.fromFile(new java.io.File(file)));
const activity = com.tns.NativeScriptApplication.getInstance().getCurrentActivity();
activity.startActivityForResult(intent, 1001);
// iOS: 使用 CoreImage 濾鏡
const ciImage = CIImage.imageWithContentsOfURL(NSURL.fileURLWithPath(imagePath));
const filter = CIFilter.filterWithName('CISepiaTone');
filter.setValue_forKey(ciImage, 'inputImage');
filter.setValue_forKey(0.8, 'inputIntensity');
const context = CIContext.contextWithOptions(null);
const cgImage = context.createCGImage_fromRect(filter.outputImage, filter.outputImage.extent);
const uiImage = UIImage.imageWithCGImage(cgImage);
tns-platform-declarations 提供完整 iOS/Android API 類型提示。| 維度 | NativeScript | React Native | Flutter | Ionic/Capacitor |
|---|---|---|---|---|
| 渲染引擎 | 原生佈局 | 原生組件(橋接) | Skia 自繪 | WebView |
| 語言 | TS/JS (+ Angular/Vue/Svelte) | TS/JS (React) | Dart | TS/JS (Angular/Vue/React) |
| 原生 API 訪問 | 直接、無橋接 | 橋接/原生模塊 | Platform Channels | Capacitor Plugins/WebView |
| 包體積 | ~15-20MB | ~20-30MB | ~10-15MB | ~5-10MB (WebView) |
| 學習曲線 | 低(Web 技能直用) | 中(React + 橋接概念) | 高(Dart + 聲明式 UI) | 低(Web 標準) |
| 適用場景 | 需大量原生 API、團隊 Web 背景、中小型應用 | 大型 React 團隊、生態豐富 | 極致性能、自定義 UI、跨平台一致性 | Web 遷移、內容型、PWA 為主 |
NativeScript 為 Web 開發者提供了零門檻進入原生移動開發的路徑:熟悉的 TS/JS/CSS、NPM 生態、Vue/Angular/Svelte 框架選擇,同時擁有100% 原生性能與 API 訪問能力。對於「團隊以 Web 為主、需快速交付原生應用、需調用大量平台特有能力(藍牙、NFC、傳感器、專用硬件)」的項目,NativeScript 是極具性價比的選擇。