Creazione di un'applicazione client utilizzando il client Amplify - AWS AppSync

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di un'applicazione client utilizzando il client Amplify

Puoi connetterti a AWS AppSync GraphQL API utilizzando qualsiasi client GraphQL, ma consigliamo vivamente il client Amplify v6. Amplify non solo genera automaticamente client fortemente tipizzati per GraphQL, ma offre anche supporto SDKs per dati in tempo reale e funzionalità avanzate di interrogazione API 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 tua configurazione per configurare Amplify:

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

Amplify.configure(config);

    In alternativa, usa lo snippet nella tua API configurazione 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, il che ti consente di risparmiare 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à il tuo API schema e, per impostazione predefinita, genererà il codice di supporto del client nella src/graphql cartella. Dopo ogni API implementazione, 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 ./