Neste artigo, vamos introduzir o conceito do Android WebView e discutir o que causa o erro NET::ERR_CLEARTEXT_NOT_PERMITTED. Em seguida, apresentaremos tr\u00eas maneiras de solucionar o problema. Vamos come\u00e7ar!<\/p>\n
O que \u00e9 o Android Webview?<\/h2>\n
Webview<\/a> \u00e9 um recurso do sistema operacional Android que permite que aplicativos exibam p\u00e1ginas da internet sem usar um navegador. Este recurso \u00e9 comum em aplicativos web, que s\u00e3o essencialmente wrappers que permitem que sites sejam instalados no seu telefone como aplicativos:<\/p>\n Embora o Webview permita que voc\u00ea acesse sites via aplicativos, voc\u00ea n\u00e3o obt\u00e9m a mesma quantidade de recursos que voc\u00ea obt\u00e9m em um navegador. Se voc\u00ea estiver navegando na internet, um navegador como o Chrome<\/a> sempre proporcionar\u00e1 uma experi\u00eancia melhor do que o Webview.<\/p>\n O erro NET::ERR_CLEARTEXT_NOT_PERMITTED \u00e9 exclusivo para aplicativos que usam o Webview no sistema operacional Android. Voc\u00ea n\u00e3o encontrar\u00e1 este erro ao usar um navegador como o Chrome. Se voc\u00ea estiver tentando acessar um site constru\u00eddo em PHP<\/a> sobre HTTP ao inv\u00e9s de um canal seguro com um navegador normal, voc\u00ea pode encontrar outros erros, como avisos “N\u00e3o Seguro”.<\/p>\n\n Se voc\u00ea configurar o Webview para carregar uma p\u00e1gina que usa HTTP<\/a> ou cont\u00e9m outros tipos de informa\u00e7\u00f5es n\u00e3o criptografadas, o aplicativo retornar\u00e1 o seguinte erro (estamos usando uma ferramenta de desenvolvimento de aplicativo Android para exemplificar):<\/p>\n O erro n\u00e3o significa que o site esteja inacess\u00edvel ou sofra de problemas t\u00e9cnicos. Na verdade, se voc\u00ea tentar acessar a mesma URL<\/a> usando outro navegador, voc\u00ea pode n\u00e3o encontrar nenhum tipo de erro. No m\u00e1ximo, se for um URL HTTP, voc\u00ea pode ver um \u00edcone que indica que voc\u00ea est\u00e1 visitando um site n\u00e3o seguro.<\/p>\n Como o erro s\u00f3 aparece dentro dos aplicativos Android, ele pode levar os usu\u00e1rios a acreditarem que existe um problema com o aplicativo em si. Entretanto, existem maneiras de contornar e solucionar esse erro, quer voc\u00ea seja um desenvolvedor de aplicativos ou voc\u00ea esteja encarregado do site que est\u00e1 exibindo-o. Se voc\u00ea \u00e9 um usu\u00e1rio final, n\u00e3o h\u00e1 muito o que voc\u00ea pode fazer al\u00e9m de tentar acessar o site usando um navegador.<\/p>\n O Android evita que aplicativos enviem dados n\u00e3o criptografados ou em “texto simples” para evitar poss\u00edveis problemas de seguran\u00e7a. Essa tem sido a configura\u00e7\u00e3o padr\u00e3o para aplicativos desde o Android 9.0.<\/p>\n Essa configura\u00e7\u00e3o se aplica aos aplicativos que usam o Android WebView. \u00c9 por isso que o erro NET::ERR_CLEARTEXT_NOT_PERMITTED s\u00f3 aparece dentro de aplicativos e n\u00e3o nos navegadores padr\u00e3o do sistema operacional Android.<\/p>\n Dado que a causa principal desse erro \u00e9 a transmiss\u00e3o de informa\u00e7\u00f5es n\u00e3o criptografadas, h\u00e1 diferentes maneiras de solucion\u00e1-lo. Se voc\u00ea \u00e9 o desenvolvedor do aplicativo, pode modificar arquivos de configura\u00e7\u00e3o para permitir o uso de “texto simples”.<\/p>\n Alternativamente, se voc\u00ea \u00e9 o propriet\u00e1rio do site, pode configurar todas as p\u00e1ginas do site para carregar atrav\u00e9s de HTTPS. Dessa forma, os usu\u00e1rios n\u00e3o ter\u00e3o que lidar com canais n\u00e3o criptografados, e os aplicativos Android que acessam seu site n\u00e3o exibir\u00e3o o erro NET::ERR_CLEARTEXT_NOT_PERMITTED.<\/p>\n Nesta se\u00e7\u00e3o, mostraremos como corrigir o erro NET::ERR_CLEARTEXT_NOT_PERMITTED diretamente no Android e no seu site. Voc\u00ea precisar\u00e1 ter acesso a um dispositivo Android para solucionar o erro e verificar se ele persiste.<\/p>\n Cada aplicativo Android inclui um arquivo AndroidManifest.xml<\/strong><\/a>. Esse arquivo cont\u00e9m informa\u00e7\u00f5es sobre o aplicativo necess\u00e1rias para o sistema operacional, a Google Play Store e algumas ferramentas de desenvolvedor.<\/p>\n O arquivo AndroidManifest.xml<\/strong> tamb\u00e9m cont\u00e9m informa\u00e7\u00f5es sobre permiss\u00f5es-chave e se o aplicativo pode carregar texto simples via Webview ou n\u00e3o. Lembre-se de que a Google desaconselha permitir texto simples devido a quest\u00f5es de seguran\u00e7a, portanto, esse m\u00e9todo de solu\u00e7\u00e3o de problemas deve ser um paliativo tempor\u00e1rio at\u00e9 que o site que voc\u00ea est\u00e1 carregando migre para o tr\u00e1fego criptografado<\/a>.<\/p>\n Para localizar e editar o arquivo AndroidManifest.xml<\/strong> (semelhante \u00e0 edi\u00e7\u00e3o de um arquivo HTML<\/a>),\u00a0voc\u00ea precisar\u00e1 de acesso ao arquivo .apk<\/strong> do aplicativo ou ao c\u00f3digo-fonte do projeto. Existem v\u00e1rias maneiras de acessar os arquivos de c\u00f3digo-fonte de um aplicativo. A abordagem recomendada \u00e9 usar o Android Studio<\/a>, que \u00e9 o Ambiente de Desenvolvimento Integrado (IDE) oficial para desenvolvedores Android:<\/p>\n Assim que voc\u00ea abrir um projeto no Android Studio<\/a>, voc\u00ea ser\u00e1 capaz de ver todos os seus arquivos relacionados por meio de diret\u00f3rios padronizados. O arquivo AndroidManifest.xml<\/strong> estar\u00e1 localizado no diret\u00f3rio de manifests<\/strong>:<\/p>\n Abra o arquivo e procure pelo subelemento do aplicativo<\/strong><\/a>, que deve se parecer com isso:<\/p>\n As vari\u00e1veis no subelemento do aplicativo\u00a0<\/strong>podem mudar, ent\u00e3o voc\u00ea precisar\u00e1 procurar pelas tags de abertura e fechamento do aplicativo <\/strong>para identific\u00e1-las. Assim que voc\u00ea localizar as tags, cole na seguinte linha de c\u00f3digo:<\/p>\n Se j\u00e1 existe uma vari\u00e1vel usesCleartexTraffic <\/strong>definida como false<\/strong>, mude-a para true<\/strong>. Quando terminar, salve as altera\u00e7\u00f5es no AndroidManifest.xml<\/strong> e feche o arquivo, depois salve as altera\u00e7\u00f5es no projeto.<\/p>\n A partir do Android 7.0, o Google permite que aplicativos usem um arquivo de configura\u00e7\u00e3o de seguran\u00e7a de rede<\/a> para definir permiss\u00f5es para dom\u00ednios e aplicativos espec\u00edficos. Em poucas palavras, voc\u00ea pode usar network_security_config.xml<\/strong> para contornar as restri\u00e7\u00f5es de cleartext para um ou mais dom\u00ednios.<\/p>\n Esta abordagem \u00e9 mais segura do que permitir o suporte de texto claro em todo o aplicativo (como mostrado no m\u00e9todo anterior). Entretanto, a abordagem mais segura seria linkar apenas para p\u00e1ginas seguras usando o Webview.<\/p>\n Idealmente, voc\u00ea usar\u00e1 apenas uma dessas duas abordagens, j\u00e1 que permitir suporte de texto claro atrav\u00e9s de todo um aplicativo significa que voc\u00ea n\u00e3o precisa permitir a lista de dom\u00ednios espec\u00edficos. Se voc\u00ea quiser optar por uma abordagem mais segura, siga este m\u00e9todo.<\/p>\n Com isso em mente, criaremos um arquivo network_security_config.xml<\/strong> para o seu aplicativo. Para fazer isso, abra o projeto do aplicativo usando o Android Studio (como descrito na se\u00e7\u00e3o anterior) e navegue at\u00e9 o diret\u00f3rio res<\/strong>.<\/p>\n Este diret\u00f3rio inclui todos os arquivos n\u00e3o codificados para um projeto de aplicativo, incluindo arquivos XML (al\u00e9m do AndroidManifest.xml<\/strong>), imagens bitmap, e muito mais. Crie um arquivo chamado network_security_config.xml <\/strong>no diret\u00f3rio res<\/strong>. Ent\u00e3o, abra o arquivo e adicione o seguinte c\u00f3digo:<\/p>\n Este c\u00f3digo especifica que apenas um dom\u00ednio pode usar cleartext. Voc\u00ea pode adicionar mais elementos “domain includeSubdomains<\/strong>” para permitir a listagem de URLs adicionais. Entretanto, por raz\u00f5es de seguran\u00e7a, recomendamos que voc\u00ea limite esta configura\u00e7\u00e3o apenas aos dom\u00ednios que estritamente precisam dela.<\/p>\n Salve as altera\u00e7\u00f5es no network_security_config.xml<\/strong> e volte para o diret\u00f3rio manifests.<\/em>\u00a0Para que a configura\u00e7\u00e3o de seguran\u00e7a da rede funcione, voc\u00ea precisar\u00e1 editar o AndroidManifest.xml<\/strong> novamente.<\/p>\n Abra o arquivo e procure pelo subelemento do aplicativo.<\/strong>\u00a0Ent\u00e3o, adicione a seguinte linha de c\u00f3digo dentro de suas tags:<\/p>\n Feche o AndroidManifest.xml<\/strong> ap\u00f3s salvar as altera\u00e7\u00f5es no arquivo e pronto. Seu aplicativo deve agora habilitar o cleartext para o dom\u00ednio que voc\u00ea especificou.<\/p>\n A solu\u00e7\u00e3o mais segura para o erro NET::ERR_CLEARTEXT_NOT_PERMITTED \u00e9 configurar o site que retorna a mensagem de erro para usar HTTPS<\/a>. Desta forma, todos os dados transmitidos de e para o site s\u00e3o criptografados.<\/p>\n Na internet moderna, n\u00e3o h\u00e1 raz\u00e3o para n\u00e3o <\/em>usar HTTPS em seu site. Voc\u00ea pode obter um certificado Secure Sockets Layer (SSL)<\/a> gratuitamente e configur\u00e1-lo no seu site em quest\u00e3o de minutos. Na verdade, alguns provedores de hospedagem de sites (como a Kinsta) podem cuidar de todo o processo para voc\u00ea.<\/p>\n Quando voc\u00ea se inscreve em um plano de hospedagem na Kinsta, configuramos automaticamente um certificado SSL para o seu site. Al\u00e9m disso, voc\u00ea pode for\u00e7ar o seu site a carregar sobre HTTPS no seu painel MyKinsta.<\/p>\n Para fazer isso, acesse o MyKinsta, selecione um site e v\u00e1 para a aba Ferramentas<\/strong>. Procure a op\u00e7\u00e3o que diz For\u00e7ar HTTPS <\/strong>e clique em Habilitar<\/strong>:<\/p>\n Se voc\u00ea n\u00e3o estiver usando Kinsta, voc\u00ea pode modificar seu arquivo .htaccess<\/strong> do WordPress para redirecionar o tr\u00e1fego HTTP atrav\u00e9s de HTTPS<\/a> ou usar um plugin que far\u00e1 o trabalho por voc\u00ea. Se voc\u00ea optar pelo \u00faltimo, recomendamos o uso do plugin Really Simple SSL<\/a>.<\/p>\n Voc\u00ea pode conferir este artigo para instru\u00e7\u00f5es sobre como redirecionar HTTP para HTTPS<\/a> no Nginx e Apache<\/a>, e usando o plugin em quest\u00e3o. Ap\u00f3s configurar seu site para usar HTTPS, voc\u00ea n\u00e3o deve mais receber o erro NET::ERR_CLEARTEXT_NOT_PERMITTED enquanto estiver usando o Android Webview para navegar nele.<\/p>\n\n Se voc\u00ea se deparar com o erro NET::ERR_CLEARTEXT_NOT_PERMITTED no Android, significa que o aplicativo que voc\u00ea est\u00e1 usando est\u00e1 tentando acessar uma p\u00e1gina da internet que quer transmitir informa\u00e7\u00f5es de texto claro ou sem seguran\u00e7a. O Android bloqueia os aplicativos de fazer isso para evitar comprometer os dados do usu\u00e1rio.<\/p>\n Se voc\u00ea \u00e9 um usu\u00e1rio regular, voc\u00ea precisar\u00e1 usar um navegador para visitar o site que est\u00e1 retornando o erro. Entretanto, se voc\u00ea \u00e9 o desenvolvedor por tr\u00e1s do aplicativo ou do site, voc\u00ea pode tentar modificar o arquivo AndroidManifest.xml<\/strong>, permitindo listar o dom\u00ednio atrav\u00e9s do network_security_config.xml<\/strong>, e for\u00e7ar seu site a usar HTTPS.<\/p>\n Os usu\u00e1rios Kinsta t\u00eam muito menos probabilidade de encontrar o erro NET::ERR_CLEARTEXT_NOT_PERMITTED em seus pr\u00f3prios sites. Isso porque configuramos automaticamente certificados SSL para novos sites e permitimos que voc\u00ea redirecione o tr\u00e1fego atrav\u00e9s do HTTPS com alguns simples cliques. Explore nossos planos de hospedagem de sites<\/a>\u00a0ou nossos planos de hospedagem de aplicativos<\/a> para encontrar a melhor op\u00e7\u00e3o!<\/p>\n","protected":false},"excerpt":{"rendered":" Se voc\u00ea est\u00e1 usando um dispositivo Android, \u00e9 poss\u00edvel que se depare com o erro NET::ERR_CLEARTEXT_NOT_PERMITTED ao tentar acessar um site ou aplicativo da internet. Esse …<\/p>\n","protected":false},"author":117,"featured_media":56915,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kinsta_gated_content":false,"_kinsta_gated_content_redirect":"","footnotes":""},"tags":[],"topic":[972,1021],"class_list":["post-56914","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","topic-codigos-status-http","topic-erros-site"],"yoast_head":"\n![\"Visualiza\u00e7\u00e3o](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/android-webview.png\")
O que significa NET::ERR_CLEARTEXT_NOT_PERMITTED?<\/h2>\n
![\"O](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/cleartext-not-permitted.png\"){kind=spacer}
O que causa o erro NET::ERR_CLEARTEXT_NOT_PERMITTED?<\/h2>\n
Como corrigir o erro “NET::ERR_CLEARTEXT_NOT_PERMITTED” (3 Maneiras)<\/h2>\n
1. Modifique o arquivo AndroidManifest.xml<\/h3>\n
![\"Android](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/android-studio.png\")
![\"AndroidManifest.xml](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/androidmanifest.png\")
<application\n\nandroid:icon=\"@drawable\/ic_launcher\"\n\nandroid:label=\"@string\/app_name\"\n\nandroid:theme=\"@style\/AppTheme\" >\n\n<\/application><\/code><\/pre>\nandroid:usesCleartextTraffic=\u201dtrue\u201d<\/code><\/p>\n2. Permita listar o dom\u00ednio usando network_security_config.xml<\/h3>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\n\n<network-security-config>\n\n<domain-config cleartextTrafficPermitted=\"true\">\n\n<domain includeSubdomains=\"true\">yourwebsite.com<\/domain>\n\n<\/domain-config>\n\n<\/network-security-config><\/code><\/pre>\nandroid:networkSecurityConfig=\"@xml\/network_security_config\"<\/code><\/p>\n3. Use a fun\u00e7\u00e3o For\u00e7ar HTTPS<\/h3>\n
![\"For\u00e7ar](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/force-https.png\")
Resumo<\/h2>\n