Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add guidance on when to use AOT compilation

Aperta
#633 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
45/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
clojure

Direzione di ricerca

Inizia esaminando il riferimento esistente sulla compilazione AOT collegato nell’issue e individua dove inserire le indicazioni sull’uso e sul non uso. Aggiungi indicazioni documentate per gli autori di applicazioni e librerie, comprese le problematiche elencate relative a dipendenze, metadati e versioni di Clojure. Il lavoro è completato quando la documentazione spiega chiaramente quando AOT è appropriato e come gli autori di librerie possono usarlo in sicurezza.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

There is a good reference on AOT compilation, but I don't see strong guidance on when to use it, or more specifically when to not use it.

My understanding is that it is relatively safe to employ AOT compilation for an app.

But sometimes a library author will naively use AOT compilation when creating their release jar without realizing the problems this can cause for users of their library. These problems include (additions and corrections most welcome):

  • aot compilation will create class files for library dependencies, this effectively brings in these dependencies (or portions of dependencies) at jar creation time, rather than runtime. A user might bring in different versions of those dependencies. Having multiple instances of a dependency on the classpath at runtime leads to confusion.
  • a class file will not include metadata such as original clojure filename and line number.
  • different versions of Clojure can generate different bytecode

I suppose a note on how/when to safely employ AOT compilation for a lib might also be helpful.

Lingua principale
HTML
Stelle
259
Fork
276
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di clojure/clojure-site

Tutte le issue di clojure/clojure-site

Issue simili

Altre issue su Compilers

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.