Creazione di un'applicazione client

Puoi connetterti alla tua API AWS AppSync GraphQL utilizzando qualsiasi client GraphQL, ma consigliamo vivamente il client Amplify. Amplify non solo genera automaticamente SDK client fortemente tipizzati per l'API GraphQL, ma offre anche supporto per dati in tempo reale e funzionalità avanzate di query GraphQL nelle applicazioni client. Per le applicazioni web, Amplify può produrre un client. JavaScript Per coloro che si rivolgono ad ambienti multipiattaforma o mobili, Amplify si rivolge ad Android, iOS e React Native. Per approfondire la generazione di codice client per queste piattaforme, consulta la documentazione di Amplify. Ecco una guida per iniziare il tuo viaggio con un'applicazione React: JavaScript

Nota

Devi installare e configurare sia npm che Amazon CLI prima di iniziare. Se utilizzi il client Amplify v6, segui questa guida.

Per iniziare

1. Sul computer locale, accedi alla directory del progetto. Installa la libreria Amplify usando il comando seguente:

   npm install aws-amplify

2. Scaricate il file di configurazione e inseritelo nella cartella del progetto. Il file di configurazione contiene in genere una config variabile con alcune impostazioni (endpoint, regione, modalità di autorizzazione, ecc.) definite. Ad esempio, potrebbe assomigliare a questo:

   const config =  {
       API: {
           GraphQL: {
             endpoint: 'https://abcdefghijklmnopqrstuvwxyz.appsync-api.us-west-2.amazonaws.com/graphql',
             region: 'us-west-2',
             defaultAuthMode: 'apiKey',
             apiKey: ''
           }
       }
   };
   
   export default config;

3. Nel tuo codice, importa la libreria Amplify e la configurazione per configurare Amplify:

   import { Amplify } from 'aws-amplify';
   import config from './aws-exports.js';
   
   Amplify.configure(config);

   In alternativa, usa lo snippet nella configurazione dell'API per configurare direttamente Amplify:

   import { Amplify } from 'aws-amplify';
   
   Amplify.configure({
     API: {
       GraphQL: {
         endpoint: 'https://abcdefghijklmnopqrstuvwxyz.appsync-api.us-west-2.amazonaws.com/graphql',
         region: 'us-west-2',
         defaultAuthMode: 'apiKey',
         apiKey: ''
       }
     }
   });

4. Utilizzando la toolchain Amplify, hai la possibilità di generare automaticamente le operazioni in base al tuo schema, risparmiando lo sforzo di scrivere script manuali. Nella directory principale dell'applicazione, utilizzate il seguente comando CLI:

   npx @aws-amplify/cli codegen add --apiId <id goes here> --region <region goes here>

   Questo scaricherà lo schema dell'API e, per impostazione predefinita, genererà il codice di supporto del client nella src/graphql cartella. Dopo ogni implementazione dell'API, puoi eseguire nuovamente il comando seguente per generare istruzioni e tipi GraphQL aggiornati:

   npx @aws-amplify/cli codegen

5. Ora puoi generare modelli per Android, Swift, Flutter e. JavaScript DataStore Usa il seguente comando per scaricare lo schema:

   aws appsync get-introspection-schema --api-id <id goes here> --region <region goes here> --format SDL schema.graphql

   Quindi, esegui il comando seguente dalla directory principale dell'applicazione:

   npx @aws-amplify/cli codegen models \
   --model-schema schema.graphql \
   --target [android|ios|flutter|javascript|typescript] \
   --output-dir ./