Premiers pas avec Perry

De zéro à un exécutable natif fonctionnel en trois étapes. Pas de Node.js, pas de bundler, aucun runtime à installer sur la machine cible.

Commencer

Installez Perry et commencez à compiler TypeScript en exécutables natifs

1Installation

terminal
$ brew tap PerryTS/perry
$ brew install perry

Nécessite Homebrew. Compatible macOS arm64 et x86_64.

2Utilisation

Compiler un fichier
perry compile main.ts

Compile main.ts en un exécutable natif

Sortie personnalisée
perry compile main.ts -o myapp

Spécifier le nom de l'exécutable de sortie

Avec le runtime V8
perry compile main.ts --enable-js-runtime

Activer V8 pour la compatibilité des paquets npm JavaScript

Vérifier la compatibilité
perry check ./src

Valider le code TypeScript pour la compilation native

Votre premier binaire, étape par étape

Une fois Perry installé, compiler TypeScript en exécutable natif tient en une seule commande. Écrivez un fichier :

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

Compilez-le et exécutez le résultat — la sortie est un binaire autonome en code machine, pas un script empaqueté :

terminal

$ perry compile hello.ts

✓ Compiled executable: hello

$ ./hello Perry

Hello, Perry!

Ce binaire démarre en environ une milliseconde et s'exécute sur toute machine ayant le même OS et la même architecture — rien à installer au préalable. Pour en savoir plus, lisez comment Perry compile TypeScript en binaire ou ce qui se passe à l'intérieur du compilateur TypeScript natif.

Et ensuite ?