BazelCon 2022 sarà in arrivo dal 16 al 17 novembre a New York e online.
Registrati oggi stesso!

Dando il tuo contributo a Bazel

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Esistono molti modi per aiutare il progetto e l'ecosistema Bazel.

Invia commenti

Mentre utilizzi Bazel, puoi scoprire aspetti che possono essere migliorati. Puoi risolvere il problema segnalando i problemi quando:

  • Bazel si arresta in modo anomalo o si verifica un bug che può essere risolto solo utilizzando bazel clean.
  • La documentazione è incompleta o poco chiara. Puoi anche segnalare i problemi dalla pagina che stai utilizzando utilizzando il link "Crea problema" nell'angolo in alto a destra della pagina.
  • Potrebbe essere migliorato un messaggio di errore.

Partecipare alla community

Puoi interagire con la community Bazel:

  • Come rispondere alle domande su Stack Overflow.
  • Aiutare altri utenti su Slack.
  • Migliorare la documentazione o fornire esempi.
  • Condividere la tua esperienza o i tuoi suggerimenti, ad esempio su un blog o sui social media.

Contribuisci al codice

Bazel è un progetto di grandi dimensioni e modificare il codice sorgente di Bazel può essere difficile.

Puoi contribuire all'ecosistema Bazel:

  • Aiutare i gestori delle regole con il contributo delle richieste di pull.
  • Creare nuove regole e renderle open source.
  • Contributo agli strumenti correlati a Bazel, ad esempio gli strumenti di migrazione.
  • Migliorare l'integrazione di Bazel con altri IDE e strumenti.

Prima di apportare una modifica, crea un problema GitHub o invia un'email a bazel-dev@.

I contributi più utili consentono di correggere bug o aggiungere funzionalità (al contrario delle modifiche stilistiche, di refactoring o "pulizia"). La modifica dovrebbe includere test e documentazione, tenendo conto della compatibilità con le versioni precedenti, della portabilità e dell'impatto sulle prestazioni e sull'utilizzo della memoria.

Per informazioni su come inviare una modifica, consulta la sezione Procedura di accettazione delle patch.

Descrizione codice di Bazel

Bazel ha un codebase di grandi dimensioni con codice in più località. Consulta la guida al codebase per ulteriori dettagli.

Bazel è organizzata come segue:

  • Il codice client si trova in src/main/cpp e fornisce l'interfaccia a riga di comando.
  • I buffer di protocollo sono in src/main/protobuf.
  • Il codice del server è in src/main/java e src/test/java.
    • Codice principale composto principalmente da SkyFrame e alcune utilità.
    • Le regole integrate sono in com.google.devtools.build.lib.rules e in com.google.devtools.build.lib.bazel.rules. Ti consigliamo di leggere in primo luogo le Sfide della scrittura di regole.
  • Le interfacce native Java sono in src/main/native.
  • Nell'elenco della sezione Compilazione Bazel sono descritti vari strumenti per il supporto delle lingue.

Ricerca del codice sorgente di Bazel

Per eseguire una rapida ricerca nel codice sorgente di Bazel, utilizza la ricerca del codice di Bazel. Puoi esplorare repository, file e rami di Bazel. Puoi anche visualizzare informazioni sulla cronologia, sulle differenze e sulle colpe. Per ulteriori informazioni, consulta la Guida dell'utente alla ricerca del codice Bzel.