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 é a possibilidade de que alguns ganchos do useQuery não sejam executados no servidor devido à renderização condicional de um componente baseado no valor retornado de getProps. 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.