Atualização para a v2.3

Se você está atualizando um projeto do PWA Kit que foi criado antes da disponibilização da v2, siga primeiro as instruções no guia Atualização para a v2.

Para aproveitar os recursos que exigem ativação disponíveis na v2.3, mais especificamente a integração react-query, você precisa fazer algumas modificações em _app-config/index.js, _app/index.js e package.json no seu projeto do PWA Kit.

Abra _app-config/index.js e faça as seguintes modificações.

Importe os componentes de ordem superior exigidos para habilitar react-query e manter a compatibilidade com getProps.

Adicione o objeto options com a configuração da React Query recomendada.

Atualize a definição do componente AppConfig exportado.

Abra _app/index.js e faça as seguintes modificações.

Declare a variável de nome DEFAULT_LOCALE para que ela armazene a localidade-padrão da exibição de mensagens no seu aplicativo. Para um projeto recém-gerado, as mensagens-padrão são gravadas em inglês para a localidade Estados Unidos. Se você não regravou as mensagens-padrão, o valor en-US é o correto para DEFAULT_LOCALE. Caso contrário, defina DEFAULT_LOCALE como outro valor, por exemplo fr-fr ou ja-jp

Atribua DEFAULT_LOCALE como o valor-padrão da propriedade targetLocale.

Substitua defaultLocale pelo novo valor estático.

Se habilitadas, as funções useQuery e getProps são executadas em paralelo. Um efeito colateral da execução em paralelo é que a renderização condicional de um componente com base no valor de retorno de getProps pode fazer com que alguns ganchos useQuery não sejam executados no servidor. Para simplificar, recomendamos que você escolha getProps ou useQuery para a busca de dados.

Adicione react-query às suas devDependencies.

Para testar se as suas alterações foram bem-sucedidas, execute os seguintes comandos:

  1. npm install para instalar a dependência react-query exigida.
  2. npm start para verificar se o aplicativo consegue ser executado localmente.
  3. npm run build para verificar se o processo de build foi bem-sucedido.
  4. npm run push (e faça a implantação via Runtime Admin) para verificar se a implantação do pacote foi bem-sucedida.

Para saber mais sobre a React Query e como usá-la, consulte a documentação da React Query.