Các dữ kiện kỹ thuật và ghi chú đo lường được duy trì bằng tiếng Anh để tránh sai lệch giữa các bản dịch.
Biên dịch ahead-of-time TypeScript sang gốc.
One Codebase, Many Targets.
Perry compiles TypeScript to native GUI and CLI apps for macOS, iOS, iPadOS, visionOS, tvOS, watchOS, Android, Wear OS, Windows, Linux, and Web/WebAssembly, with a separate HarmonyOS preview. Native binaries statically link the Perry runtime and GC; they do not require Node.js or an external JavaScript engine.
$ perry compile main.ts
Đang biên dịch main.ts...
✓ Example executable written: main (size varies by linked features)
$ ./main
Hello, World!
Ứng dụng thực, biên dịch từ TypeScript với Perry.
Tại sao chọn Perry?
The current compiler, runtime, UI, and tooling surfaces — with limitations called out
No External JS Engine
Native builds run without Node.js, Bun, Deno, or an external JavaScript engine installed. The Perry runtime and garbage collector are statically linked into each target-specific binary.
Biên dịch nhanh
Biên dịch trực tiếp TypeScript sang mã gốc sử dụng SWC để phân tích cú pháp và LLVM để sinh mã tối ưu. Không có JavaScript trung gian.
Size Scales With Features
Hello world can be about 330 KB and Mango is published at about 7 MB. Applications that link the full standard library or optional V8 fallback can be much larger; size depends on target, imports, and build profile.
Cacheable Builds
Perry caches module objects and can pin a CPU baseline for portable output. Default host builds tune for the local CPU, and final binaries may contain platform UUIDs, timestamps, or signatures, so byte-for-byte cross-machine reproducibility is not promised.
Tracked Node.js APIs
Native implementations cover many familiar Node.js APIs across 53 tracked modules. Coverage is broad but not complete; use perry check and the published limitations for your project.
Các package npm thực tế
Many pure TypeScript and JavaScript packages compile natively. Packages that depend on unsupported dynamic or engine-specific semantics may need the optional embedded V8 fallback or may not work.
35+ Native UI Widgets
35+ native UI widgets map to platform toolkits including AppKit, UIKit, GTK4, Win32, Android SDK APIs, SwiftUI on watches, and a DOM/CSS bridge on Web/WASM. Availability varies by target.
Compile-Time Plugin System
Modules can compose at build time and statically linked dependencies can become direct native calls. Dynamic dispatch and runtime support remain where JavaScript semantics require them.
True Multi-Threading
Real OS threads with parallelMap, parallelFilter, and spawn. Mutable captures are rejected by default; SharedArrayBuffer and Atomics provide explicit shared-memory coordination, with documented typed-view caveats.
Compile-Time i18n
Automatic string extraction, CLDR plural rules for 30+ locales, and compile-time validation. Translations are baked into the binary; lookup cost depends on the generated catalog and call site.
Tìm hiểu sâu hơn: cách Perry biên dịch TypeScript thành binary, điều gì khiến nó trở thành một trình biên dịch TypeScript gốc, và nó so sánh thế nào với các giải pháp thay thế Electron.
Xem mọi người xây dựng gì
Public native applications compiled from TypeScript, with platforms and capabilities taken from their current project pages.
Mango
GUI MongoDB native — xây dựng hoàn toàn bằng TypeScript
Hone
Trình soạn thảo code native hỗ trợ AI — TypeScript sang binary native
Native across documented targets
Eleven documented targets share Perry’s compiler and UI model. Web and WASM are aliases; visionOS, watchOS, and Wear OS have narrower core support, and HarmonyOS is a separate preview.
macOS
AppKit
iOS
UIKit
iPadOS
UIKit
visionOS
UIKit (2D)
tvOS
UIKit
watchOS
SwiftUI
Android
Android SDK
Wear OS
Android SDK
Windows
Win32
Linux
GTK4
Web / WASM
DOM/CSS bridge
--target web and --target wasm are aliases
HarmonyOS
ArkUI
Separate preview; not included in the 11 documented targets
11 documented targets; HarmonyOS is listed separately as a preview. See the platform status guide
Từ mã nguồn đến App Store
The perry publish command supports build, signing, packaging, verification, and submission workflows. Availability and prerequisites vary by platform and hosted-service configuration.
Build & Sign
Create platform artifacts and use configured signing credentials. Apple, Android, and Windows workflows require their platform SDKs, accounts, and certificates.
Distribute
Prepare store submissions or direct-download artifacts for supported targets. Store acceptance and processing remain controlled by each store.
Verify
Run available launch and UI checks through Perry and Geisterhand. Test depth and target coverage depend on the selected environment.
Local compilation is free and MIT licensed. Check hosted-service availability → /publish
Perry’s native compilation model
Ahead-of-time machine code and real platform widgets, with an explicitly linked runtime and documented compatibility tradeoffs.
Designed for
- ✓Ahead-of-time machine code through LLVM
- ✓Real platform widgets where each target supports them
- ✓No external Node.js installation or JavaScript engine by default
Tradeoffs to evaluate
- –The Perry runtime and GC are statically linked; overhead is not “none”
- –Perry implements a practical TypeScript and Node.js subset; some packages need the optional V8 fallback
- –Platform capabilities and maturity differ across desktop, mobile, wearable, TV, and Web/WASM targets
Competitor-specific pages are dated and link to upstream documentation. View sourced comparisons
Viết TypeScript, xuất bản gốc
Use familiar TypeScript syntax and validate each API or package against Perry’s current compatibility surface.
// hello.tsconst greeting = "Hello, World!";console.log(greeting); // Output size varies with target and linked features// No external JavaScript runtime installation needed!Published measurements
Current public results include wins, mixed results, and losses. Treat microbenchmarks as workload-specific measurements, not a universal speed claim.
| Chỉ số | Perry | Node.js | Bun |
|---|---|---|---|
| Kích thước binary | ~330 KB hello world; ~7 MB Mango | Application plus an installed Node.js runtime | Standalone executable embeds the Bun runtime |
| Thời gian khởi động | ~3.2 ms* | Engine boot and warmup; workload-dependent | Engine boot and warmup; workload-dependent |
| Phụ thuộc runtime | Statically linked Perry runtime + GC | External Node.js runtime | Embedded Bun / JavaScriptCore runtime |
| Chi phí bộ nhớ | Workload-dependent | Workload-dependent | Workload-dependent |
* Measured runtime-only macOS hello world on an Apple M-series host (5.0 → 3.2 ms after removing unused dynamic-library links). Application startup varies.
Full public suite: wins and losses
Perry 0.5.1355 · Node.js 22.23.1 · Bun 1.3.14 · Apple M1, 8 GB · 2026-08-08
Lower wall-clock median is better. Five complete process samples; correctness checks passed. Benchmark names and descriptions remain English technical identifiers.
| Benchmark | Perry | Node.js | Bun | Result |
|---|---|---|---|---|
factorial Modular accumulation | 94 ms | 95 ms | 95 ms | Win vs both |
method calls Class method dispatch | 9 ms | 10 ms | 8 ms | Mixed |
closure Closure creation and invocation | 47 ms | 49 ms | 49 ms | Win vs both |
binary trees Tree allocation and traversal | 4 ms | 6 ms | 6 ms | Win vs both |
string concat String append loop | 2 ms | 4 ms | 1 ms | Mixed |
prime sieve Sieve of Eratosthenes | 28 ms | 6 ms | 5 ms | Loss vs both |
mandelbrot Complex-number iteration | 22 ms | 24 ms | 28 ms | Win vs both |
matrix multiply Matrix multiplication | 85 ms | 33 ms | 33 ms | Loss vs both |
JSON roundtrip Parse and stringify ~1 MB JSON | 184 ms | 380 ms | 220 ms | Win vs both |
Bắt đầu
Cài đặt Perry và bắt đầu biên dịch TypeScript thành tệp thực thi gốc
1Cài đặt
$ npm install -g @perryts/perryRecommended cross-platform install. Native targets still require the relevant platform SDK and linker; run perry doctor after installation.
2Sử dụng
perry doctorChecks the compiler, linker, SDK, and target setup
perry compile main.tsBiên dịch main.ts thành tệp thực thi gốc
perry compile main.ts -o myappChỉ định tên tệp thực thi đầu ra
perry compile main.ts --enable-js-runtimeBật V8 để tương thích với các gói npm JavaScript
perry check ./srcXác thực mã TypeScript cho biên dịch gốc
Hỗ trợ tính năng
Tested surfaces and known partial areas — not a blanket claim of complete TypeScript or Node.js compatibility
Ngôn ngữ cốt lõi
- ✓Numbers (f64 + selected unboxed representations)
- ✓Strings (UTF-8)
- ✓Booleans
- ✓Arrays
- ✓Objects
- ✓BigInt (fixed 1024-bit)
- –Proxy
- –eval / runtime-generated code
Hàm
- ✓Function declarations
- ✓Arrow functions
- ✓Default parameters
- ✓Rest parameters
- ✓Closures
- ✓Higher-order functions
- ✓Async / await
- –Runtime-computed dynamic import
Lớp
- ✓Classes and constructors
- ✓Private fields (#)
- ✓Static methods / fields
- ✓Getters / setters
- ✓Inheritance and super
- –Decorators and reflection
- –Dynamic prototype manipulation
- –Weak references / finalizers
Hệ thống kiểu
- ✓Type annotations
- ✓Local type inference
- ✓Generics / specialization
- ✓Interfaces
- ✓Union types and guards
- –Runtime type validation
Thư viện chuẩn
- –fs / path / os
- –crypto
- –Buffer and streams
- –http / http2 / net / tls
- –child_process / worker_threads
- –WebAssembly global
- –~97% Node suite · 53 modules
“Partial” means the API or syntax exists with documented gaps. Exact behavior changes as parity work lands. Read the current limitations
~50 Native Packages and Node APIs
Many popular packages and Node APIs have native implementations. Coverage is package- and feature-specific; perry check and the compatibility documentation are the source of truth.
Cơ sở dữ liệu
Bảo mật
HTTP
Xử lý dữ liệu
Ngày và giờ
Tiện ích
Cách hoạt động
From TypeScript source through SWC, Perry HIR, LLVM, and the linked runtime
Muốn biết trình biên dịch hoạt động bên trong như thế nào? Cấu trúc bên trong trình biên dịch
Tìm hiểu chuyên sâu: TypeScript trên LLVM — monomorphization, NaN-boxing, và lý do Perry rời bỏ Cranelift.
Nơi mã Perry có thể nghỉ và chạy.
Coop biến một thư mục TypeScript tương thích với Perry thành thư viện ứng dụng native và phục vụ qua HTTP, trong khi runtime và thư viện chuẩn Perry chỉ được cung cấp một lần trên mỗi máy.
- ✓Runtime dùng chung
- ✓Một worker cho mỗi triển khai
- ✓Triển khai, kiểm tra và rollback
Các câu hỏi thường gặp
Mọi điều mọi người thắc mắc trước khi biên dịch binary đầu tiên của mình
Perry có cần Node.js hay runtime không?
Native Perry binaries run without Node.js, Bun, Deno, or an external JavaScript engine installed. They do include the Perry runtime and garbage collector, statically linked. Packages that need engine semantics can use the optional embedded V8 fallback.
Các binary đã biên dịch lớn cỡ nào?
Size depends on the target, imports, and build profile. The published examples range from about 330 KB for hello world to about 7 MB for Mango; full-standard-library or optional-V8 builds can be much larger. Treat any size as a measured example, not a universal output size.
Tôi có thể dùng gói npm không?
Many pure TypeScript/JavaScript packages compile natively, and roughly 50 package/API implementations are tracked. Compatibility is not universal: packages using native addons, unsupported dynamic behavior, or engine-specific semantics may need the optional V8 fallback or may not work. Run perry check and consult the limitations.
Perry hỗ trợ những nền tảng nào?
Perry documents 11 targets: macOS, iOS, iPadOS, visionOS, tvOS, watchOS, Android, Wear OS, Windows, Linux, and Web/WASM. Web and WASM are aliases; HarmonyOS is a separate preview. Platform maturity and API coverage differ, so consult the platform guide.
Perry có miễn phí và mã nguồn mở không?
The compiler and runtime repository is MIT licensed, and local compilation requires no account. Hosted Perry Publish and commercial support are separate services; availability, limits, and pricing are confirmed in the service or in writing.
Perry khác gì so với Bun hay Deno compile?
Bun and Deno standalone executables bundle their runtimes; Perry native builds compile through LLVM and do not embed a JavaScript engine by default, although they statically link the Perry runtime and GC. Exact size and startup comparisons are version-, platform-, and workload-specific. See the dated Perry vs Bun and Perry vs Deno pages.
Perry khác gì so với Electron hay Tauri?
Electron ships Chromium and Node.js; Tauri uses a system webview with native-side application code. Perry instead maps its UI model to platform widgets where supported. Bundle size and platform capability vary, so use the dated Perry vs Electron and Perry vs Tauri comparisons rather than a universal size claim.
Perry đã trưởng thành đến mức nào?
Perry is pre-1.0 and changes quickly. Real projects use it today, but language, package, and platform parity are still active work. Review the showcase, current limitations, and changelog before committing a production workload.
Còn thắc mắc khác? Đọc hướng dẫn bắt đầu hoặc hỏi trên GitHub Discussions.