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:
npm install
para instalar a dependênciareact-query
exigida.npm start
para verificar se o aplicativo consegue ser executado localmente.npm run build
para verificar se o processo de build foi bem-sucedido.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.