Migração da versão 2.x.x para a 3.0.0

A versão 3.0.0 do DotNetBrowser traz melhorias tanto para os recursos internos quanto para a API pública da biblioteca. Este guia mostra como tornar o código da sua aplicação escrito com a versão 2.x.x do DotNetBrowser compatível com a versão 3.0.0

Por quê migrar?

Recomendamos que você atualize seu código para a versão mais recente, pois todos os novos recursos, atualizações do Chromium, suporte a novos sistemas operacionais e versões do .NET, correções de bugs, patches de segurança, melhorias de desempenho e otimizações no uso de memória são aplicados com base na versão mais recente.

Quanto tempo demora?

Com base em nossa experiência, a atualização para uma nova versão pode levar de algumas horas a alguns dias, dependendo do número de recursos utilizados na sua aplicação. Como de costume, recomendamos fortemente testar seu software após a atualização em todos os ambientes que ele suporta.

Obter ajuda

Caso você não encontre a resposta neste guia e precise de assistência com a migração, por favor, entre em contato conosco. Ficaremos felizes em ajudar.

Principais alterações

A API obsoleta foi removida

A API que anteriormente foi marcada como obsoleta no DotNetBrowser 2 não está mais disponível na versão 3.0.0.

Aqui está a lista da API removida e suas substituições:

• LoadUrlParameters.PostData, que foi substituído por LoadUrlParameters.UploadData;
• VerifyCertificateParameters.VerifyStatuses, que foi substituído por VerifyCertificateParameters.VerifyErrors;
• BinariesExtractionOptions.CheckLastModificationDate, que foi substituído por BinariesExtractionOptions.VerificationLevel;
• ISpellChecker.DictionaryNames, que foi substituído por ISpellChecker.Languages.

As seguintes propriedades estavam anteriormente disponíveis na interface IEngine. No entanto, elas estavam relacionadas ao perfil padrão e foram marcadas como obsoletas:

• IEngine.CookieStore
• IEngine.Downloads
• IEngine.HttpCache
• IEngine.Network
• IEngine.Permissions
• IEngine.Plugins
• IEngine.Proxy
• IEngine.SpellChecker
• IEngine.ZoomLevels

Essas propriedades foram removidas da interface IEngine e agora estão disponíveis apenas no perfil padrão. Por exemplo, se você estava utilizando engine.Network, agora deve usar engine.Profiles.Default.Network.

A opção GoogleTrafficDisabled foi removida.

Alguns de nossos clientes relataram que o Chromium às vezes envia solicitações inesperadas para serviços web externos. Descobrimos que recursos do Chromium, como Google Cloud Messaging, Translate Ranker, Extensions Updater, Safe Browsing, Spell Checker, Widevine, entre outros, fazem solicitações para serviços web externos do Google, como https://ssl.gstatic.com e https://clients4.google.com, para funcionarem corretamente.

Entendemos que qualquer solicitação inesperada a um serviço web externo pode ser tratada como uma ameaça à segurança e deve ser bloqueada. Analisamos todos os recursos do Chromium que enviam solicitações a serviços web externos e garantimos que você tenha total controle sobre eles por meio da API do DotNetBrowser. Os recursos que não podem ser controlados pela API estão desativados por padrão para evitar solicitações inesperadas a serviços web externos.

No contexto dessa melhoria, removemos a opção GoogleTrafficDisabled do Engine, pois ela não é mais necessária.