Conoscere la galleria di esempi
Gli obiettivi di questo progetto sono:
- Conoscere le app di esempio.
- Scoprire dove sono e perché vengono create.
- Esaminare gli strumenti comuni per le app di esempio.
App di esempio Trailhead
Per gli sviluppatori, osservare il codice di qualcun altro è un metodo collaudato per imparare come far funzionare qualcosa. Lo stesso vale per le persone che imparano per la prima volta come si diventa sviluppatori.
Le app di esempio Trailhead forniscono esempi di codice per una serie di funzionalità dedicate agli sviluppatori su Salesforce Platform. Abbiamo creato delle app di esempio per aiutarti a sfruttare la tecnologia Salesforce più recente e avanzata.
Trovare le app di esempio
Le app di esempio Trailhead si trovano in un'organizzazione GitHub dedicata. Ecco come si fa a trovarle.
- Apri il tuo browser preferito.
- Vai a github.com/trailheadapps
- Fatto! Hai trovato le nostre app di esempio.
Contenuto dell'organizzazione delle app di esempio Trailhead
La prima cosa da sapere è che le app di esempio Trailhead sono destinate a tutti gli sviluppatori che stanno imparando a lavorare con le tecnologie Salesforce e possono essere usate tutte come risorse indipendenti. Ognuna comprende risorse autoguidate che aiutano ad acquisire familiarità con il contenuto dell'app. Se le visualizzi in Visual Studio Code, troverai un tour del codice, che consente di esaminare alcuni frammenti di codice essenziali direttamente nell'editor. Dopo aver distribuito l'app nell'organizzazione Salesforce, puoi approfondirne la conoscenza attraverso la guida in-app.
Ma diverse app di esempio sono presenti soprattutto nei moduli e nei progetti Trailhead. In alcuni casi, le app sono state create appositamente a supporto del contenuto Trailhead. In altri casi, abbiamo creato le app e sono state adottate dagli autori dei contenuti Trailhead come casi d'uso comuni. Conosciamole meglio.
- Scorri la galleria di esempi.
- Noterai che il riquadro di ogni app ha una sezione Description and Features (Descrizione e funzionalità) espandibile.
- Cerca l'app LWC Recipes. Espandi la sezione Description and Features (Descrizione e funzionalità).
- Dedica un momento a leggere la descrizione e le funzionalità nel relativo riquadro.
- Nota anche il link al progetto Trailhead dove sono disponibili informazioni approfondite sull'app di esempio.
- Ora trova l'app denominata ECars e leggi la descrizione, le funzionalità e il link all'app di esempio.
- Dedica un po' di tempo in più a consultare altre descrizioni delle app.
Come puoi notare, alcune di queste app simulano un caso d'uso del cliente. Altre mostrano esempi di codice senza un caso d'uso, solo per dimostrare il funzionamento di alcune API e funzionalità per sviluppatori.
App con caso d'uso: le app con caso d'uso sono create ciascuna sulla base di un caso d'uso di un cliente fittizio. Tendono a concentrarsi su un sottoinsieme delle funzionalità per sviluppatori di Salesforce Platform che è utile imparare. Alcune di queste sono: Community, Heroku, integrazione con Slack, creazione di pacchetti e dipendenze. Se scorri tutte le app, ne troverai altre.
App con esempi di codice: queste app mostrano come risolvere problemi di codifica, ma non cercano necessariamente di raccontare la storia di un cliente.
Alcune app usano uno stile che chiamiamo "ricetta", ossia spiegano in che modo risolvere un problema specifico. Le soluzioni provano a mostrare il codice più semplice per risolverlo. Ogni esempio di codice (come un file JS o un metodo Apex) viene denominato in modo da identificare il tipo di problema che risolve. Ad esempio, nell'app LWC Recipes troverai un componente Web Lightning denominato wireGetRecordStaticContact
che utilizza un adattatore wire per ottenere un record referente utilizzando nomi di campo statici. Oltre a LWC Recipes, troverai anche Apex Recipes, Functions Recipes e LWC Recipes Open Source.
Esistono altre app con esempi di codice oltre alle app delle "ricette". Queste app illustrano modelli di codifica e di sviluppo specifici per le funzionalità di Salesforce Platform. Esempi di queste sono le app Visualforce to LWC e Automation Components.
Ora che ti abbiamo presentato le app di esempio, diamo un'occhiata al codice.
Repository del codice delle app di esempio
La pagina di destinazione dell'organizzazione GitHub funge da directory delle nostre app di esempio attive. In questo modo è facile per vedere tutte le app di esempio e poi passare al repository per l'app di esempio che ci interessa.
- Scorri fino al riquadro dell'app LWC Recipes.
- Fai clic sul nome dell'app di esempio, LWC Recipes.
- Si apre il repository GitHub di LWC Recipes.
Oltre alle app che gestiamo attivamente, nel corso degli anni abbiamo archiviato un certo numero di app. Fai clic sul pulsante Indietro e poi sul link Repositories (Repository) nella barra di navigazione di GitHub per visualizzare alcuni altri repository pubblici. Alcuni di questi possono contenere altri esempi interessanti e pertinenti per determinati sviluppatori. Tieni presente però che non gestiamo più attivamente queste app.
Finora, hai imparato a conoscere l'organizzazione GitHub delle app di esempio Trailhead. Hai anche scoperto lo scopo delle diverse app di esempio e hai imparato ad accedere al repository dell'app di esempio LWC Recipes. Nella fase successiva, imparerai come si configurano gli strumenti per queste app e come trovare i diversi elementi utilizzati dagli strumenti.
Non faremo alcuna verifica del tuo lavoro in questa fase. Fai clic su Verify step to earn 100 points (Verifica il passaggio per guadagnare 100 punti) per passare alla fase successiva del progetto.