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.

Get Started with Perry

From zero to a running native executable in three steps. Native output does not need Node.js or an external JavaScript engine on the target machine; Perry's runtime and GC are linked into it.

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

terminal
$ npm install -g @perryts/perry

Recommended cross-platform install. Native targets still require the relevant platform SDK and linker; run perry doctor after installation.

2Sử dụng

Verify the toolchain
perry doctor

Checks the compiler, linker, SDK, and target setup

Biên dịch tệp
perry compile main.ts

Biên dịch main.ts thành tệp thực thi gốc

Đầu ra tùy chỉnh
perry compile main.ts -o myapp

Chỉ định tên tệp thực thi đầu ra

Với V8 runtime
perry compile main.ts --enable-js-runtime

Bật V8 để tương thích với các gói npm JavaScript

Kiểm tra tương thích
perry check ./src

Xác thực mã TypeScript cho biên dịch gốc

Your first binary, step by step

Once Perry is installed, compiling TypeScript to a native executable is a single command. Write a file:

hello.ts
const name = process.argv[2] ?? "World";
console.log(`Hello, ${name}!`);

Compile it and run the result — the output is a self-contained machine-code binary, not a bundled script:

terminal

$ perry compile hello.ts

✓ Compiled executable: hello

$ ./hello Perry

Hello, Perry!

The published runtime-only hello-world measurement is about 3.2 ms on the documented Apple M-series test host. Real startup depends on the target, linked features, I/O, and hardware. Read more about how Perry compiles TypeScript to a binary or what happens inside the TypeScript native compiler.

Where to go next