banner-image-2024-04-30T03:03:58.047Z

Imagem de Atualize o Appmetrics para executar no Node 12 no tecmundo

Aprenda como atualizar um add-on Node.js escrito em C++ para executar no Node.js 12

Recentemente, eu atualizei um add-on Node.js escrito em C++ para executar no Node.js 12. Quando comecei, eu tinha pouco conhecimento de C++ ou de como desenvolver add-ons Node.js, ent&atilde;o estou compartilhando o que aprendi para deixar o processo mais f&aacute;cil para outros que enfrentem desafios similares.
Antes da atualiza&ccedil;&atilde;o, tentar compilar a V4 do <a href="https://github.com/RuntimeTools/appmetrics">Appmetrics</a> (Node Application Metrics) no Node.js 12 implicava muitos erros de compila&ccedil;&atilde;o. Os erros ocorriam porque o Node.js 12 &eacute; executado em uma vers&atilde;o mais nova do <a href="https://github.com/v8/v8">Google V8 engine</a> (vers&atilde;o 7.4), que descontinuou diversas fun&ccedil;&otilde;es. Apesar de o Google V8 <a href="https://docs.google.com/document/d/1g8JFi8T_oAE_7uAri7Njtig7fKaPDfotU6huOa1alds/edit">listar suas descontinua&ccedil;&otilde;es</a>, eles n&atilde;o explicam como consertar o c&oacute;digo desatualizado!
Neste post, eu compartilho com voc&ecirc; os passos que segui para fazer meu c&oacute;digo ser executado sem erros e como voc&ecirc; pode executar seus pr&oacute;prios add-ons Node.js C++ no Node.js 12.
Para ver um resumo das mudan&ccedil;as de c&oacute;digos diretamente, confira as sugest&otilde;es de melhoria no Github (mas observe tamb&eacute;m o aviso abaixo)
<h2 dir="ltr">Aprendendo com o exemplo</h2>
Eu n&atilde;o tinha um hist&oacute;rico grande de trabalho com Appmetrics, C++ ou add-ons do Node.js, ent&atilde;o aprendi tentando aplicar os exemplos de outras pessoas e descobrindo o que funcionava e por qu&ecirc;.
Para come&ccedil;ar, atualizei a sintaxe do meu c&oacute;digo C++ nativo e deixei o Appmetrics rodando no Node.js. No entanto, agora o meu C++ j&aacute; n&atilde;o rodava mais no Node.js 8, porque meus arranjos usaram uma sintaxe que foi introduzida ap&oacute;s o Node.js 8. Para contornar essa situa&ccedil;&atilde;o, eu poderia ter recorrido a blocos if-else pr&eacute;-compilados para executar o c&oacute;digo correto para as vers&otilde;es 8, 10 e 12 do Node.js, respectivamente, mas isso seria grosseiro e provavelmente demandaria extens&otilde;es para rodar em vers&otilde;es futuras do Node.js.
<h2 dir="ltr">Usando o NAN para o resgate</h2>
Ent&atilde;o eu descobri o <a href="https://github.com/nodejs/nan">NAN (Native Abstractions for Node.js) &mdash; Abstra&ccedil;&otilde;es Nativas para Node.js</a>. A API do NAN fica mais ou menos da mesma forma na maioria das vers&otilde;es do Node.js, n&atilde;o importa qual vers&atilde;o do Google V8 engine estiver rodando. Ent&atilde;o eu converti v&aacute;rios tipos e fun&ccedil;&otilde;es nativos C++ para tipos e fun&ccedil;&otilde;es NAN, delegando efetivamente ao NAN a tarefa de manter a compatibilidade ao longo das vers&otilde;es mais importantes do Node.js.
Existe uma alternativa mais moderna ao NAN, chamada <a href="https://nodejs.org/api/n-api.html#n_api_n_api">N-API</a>. Ela tamb&eacute;m tem o objetivo de proporcionar uma API simples que se mant&eacute;m compat&iacute;vel com a maioria das vers&otilde;es do Node.js. Enquanto o NAN isola voc&ecirc; da maioria das atualiza&ccedil;&otilde;es do API do Google V8 (mas n&atilde;o todas), a N-API o isola de todas elas.
Usei o NAN em vez da N-API porque ele j&aacute; estava parcialmente na base do c&oacute;digo. Eu precisava executar o Appmetrics no Node 12 rapidamente, ent&atilde;o implementei o ajuste mais r&aacute;pido primeiro: estendendo nosso uso do NAN. Mas se voc&ecirc; est&aacute; desenvolvendo um add-on do Node.js desde o in&iacute;cio, tente usar a N-API.
<h2 dir="ltr">Conclus&atilde;o</h2>
Depois de realizar v&aacute;rias pesquisas no Google, experimentar e conversar com colegas, consegui fazer com que o Appmetrics compilasse no Node.js as vers&otilde;es 8, 10 e 12 ao converter um pouco da sintaxe nativa do C++ para tipos e fun&ccedil;&otilde;es NAN. A maior parte do nosso c&oacute;digo ainda est&aacute; em C++ nativo, cujas partes provavelmente ainda ser&atilde;o descontinuadas em futuras vers&otilde;es do Node.js. Para ficar &agrave; frente das pr&oacute;ximas descontinua&ccedil;&otilde;es, devemos resolver os avisos de desatualiza&ccedil;&atilde;o antes que se tornem erros, usando o NAN ou a N-API.
<h2 dir="ltr">Aviso</h2>
Se voc&ecirc; <a href="https://github.com/RuntimeTools/appmetrics/pull/576">olhar minhas mudan&ccedil;as de c&oacute;digo nessa sugest&atilde;o de melhoria</a>, ver&aacute; que estou usando tipos Local em vez dos novos tipos MaybeLocal apresentados na vers&atilde;o 7.4 do Google V8 engine (no qual o Node.js roda).
Usar demais os tipos Local n&atilde;o &eacute; uma das melhores pr&aacute;ticas, mas foi necess&aacute;rio para que o Appmetrics rodasse no Node 12 o mais r&aacute;pido poss&iacute;vel. No entanto, voltar aos tipos MaybeLocal seria mais seguro.
O risco &eacute; que as chamadas C++ que podem retornar internamente ao Javascript fornecido pelo usu&aacute;rio falhem. O MaybeLocal&lt;&gt; &eacute; uma classe empacotadora para a classe Local&lt;&gt; que imp&otilde;e que se verifique se Local&lt;&gt; est&aacute; vazia antes de ser usada. Isso faz com que possamos colocar uma exce&ccedil;&atilde;o na falha em vez de abortar.&nbsp;
Para mais informa&ccedil;&otilde;es relacionadas a esse aviso, confira:
<ul>
<li dir="ltr">
<a href="https://v8docs.nodesource.com/node-4.8/d8/d7d/classv8_1_1_maybe_local.html">V8 docs</a>
</li>
<li dir="ltr">
<a href="https://stackoverflow.com/a/47144507">Explica&ccedil;&atilde;o do StackOverflow</a>
</li>
<li dir="ltr">
<a href="https://github.com/nodejs/nan/issues/749">Usando Nan:MaybeLocal</a>
</li>
</ul>
...
Quer ler mais conte&uacute;do especializado de programa&ccedil;&atilde;o? Conhe&ccedil;a a&nbsp;<a href="https://www.tecmundo.com.br/desenvolvendo-com-ibm-cloud?utm_source=tecmundo&amp;utm_medium=cta&amp;utm_campaign=ibm-blue-profile" target="_blank">IBM Blue Profile</a>&nbsp;e tenha acesso a mat&eacute;rias exclusivas, novas jornadas de conhecimento e testes personalizados. Confira agora mesmo, consiga as badges e d&ecirc; um upgrade na sua carreira!

thumb-image-2024-04-30T03:03:58.047Z

Atualize o Appmetrics para executar no Node 12

A Queda de P. Diddy estreia 1º de fevereiro no @streammaxbr! O documentário revela os bastidores das polêmicas que abalaram a carreira do rapper. Você vai assistir? 👀🎬 #AQuedaDePDiddy #PDiddy #Documentário #TrueCrime #Max #Streaming

💥🚨 Novo Documentário BOMBÁSTICO sobre P. Diddy!

Os melhores EASTER EGGS de Seu Amigão da Vizinhança Homem-Aranha, nova animação da Marvel! #MCU #Marvel #HomemAranha #SpiderMan #peterparker #SeuAmigãodaVizinhançaHomemAranha

🕷️🕸️ EASTER EGGS DA NOVA ANIMAÇÃO DE HOMEM-ARANHA

O choque ao assistir esse filme pela primeira vez e a tristeza 🥺 #cenasdefilmes #umolhardoparaiso #saoirseRonan #stanleytucci

"Meu sobrenome é Salmão, igual ao peixe. Primeiro nome: Susie." 😢

Melhores Cenas

Os fones mais diferenciados da Huawei tanto em design quanto em funcionalidade estão recebendo oficialmente uma cor nova aqui no Brasil! É o FreeClip, que têm características que a gente não encontra na grande maioria dos fones de ouvido, mesmo entre os modelos True Wireless. 🔥 Saiba mais sobre o Huawei FreeClip: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/FreeClipHuawei #[Tipo: Publieditorial] #[Tipo: Shorts] Extensão do TecMundo: encontre cupons escondidos nas principais lojas online: <a href="http://" target="_blank" rel="nofollow noopener">http://</a>bit.ly/3ZkKOji - Os melhores cupons Online para você! <a href="https://www." target="_blank" rel="nofollow noopener">https://www.</a>tecmundo.com.br/cupons 💡 Participe dos canais do TecMundo no WhatsApp! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatstecmundo - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsmegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JSpOKX 💡 Temos grupos também no Telegram! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JZoTbm - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegrammegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramthebrief CRÉDITOS Roteiro: Leonardo Rocha Apresentação: Leonardo Rocha Imagens e áudio: Felipe Pedro (Felps) e Gustavo Katsumi Produção: Diana Pordeus e Vitória Schmitz Edição de vídeo: Larissa Kinoshita A melhor programação está no TecMundo - História da Tecnologia - Análises, Unboxings e tudo sobre Produtos! - TecDocs - Matérias especiais - Assistência Tec - Lives de tradução e cobertura de eventos - Listas - Hoje no TecMundo #Tecnologia #FashionForward #TecMundo

Tem cor nova chegando para os fones mais diferenciados da #Huawei ! #huaweifreeclip #fashioedge

Dicas e apresentações de produtos, softwares e serviços

Shorts

Um smartwatch premium de verdade precisa combinar tecnologias e recursos avançados com um design elegante e sofisticado que você só encontra em um acessório de luxo. E o Huawei Watch ULTIMATE traz essa combinação como nenhum outro relógio conectado faz! - Saiba mais sobre o Huawei Watch Ultimate: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/huaweiultimate #[Tipo: Publieditorial] #[Tipo: Shorts] Extensão do TecMundo: encontre cupons escondidos nas principais lojas online: <a href="http://" target="_blank" rel="nofollow noopener">http://</a>bit.ly/3ZkKOji - Os melhores cupons Online para você! <a href="https://www." target="_blank" rel="nofollow noopener">https://www.</a>tecmundo.com.br/cupons 💡 Participe dos canais do TecMundo no WhatsApp! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatstecmundo - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsmegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JSpOKX 💡 Temos grupos também no Telegram! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JZoTbm - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegrammegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramthebrief CRÉDITOS Roteiro: Leonardo Rocha Apresentação: Leonardo Rocha Imagens e áudio: Felipe Pedro (Felps) e Gustavo Katsumi Produção: Vitória Schmitz Edição de vídeo: Larissa Kinoshita A melhor programação está no TecMundo - História da Tecnologia - Análises, Unboxings e tudo sobre Produtos! - TecDocs - Matérias especiais - Assistência Tec - Lives de tradução e cobertura de eventos - Listas - Hoje no TecMundo #huaweiultimate #fashionforward #tecmundo

O smartwatch premium de verdade que você merece! Huawei Watch ULTIMATE #fashionedge #huawei

O SSD externo Lexar SL400 é um acessório que promete entregar um setup profissional para você que usa sempre o celular para criar conteúdo. Ele traz um pacote muito completo que inclui até um hub USB-C, aí você consegue plugar microfones, carregadores e outros acessórios ao mesmo tempo. 🔥 Extensão do TecMundo: encontre cupons escondidos nas principais lojas online: <a href="http://" target="_blank" rel="nofollow noopener">http://</a>bit.ly/3ZkKOji - Os melhores cupons Online para você! <a href="https://www." target="_blank" rel="nofollow noopener">https://www.</a>tecmundo.com.br/cupons 💡 Participe dos canais do TecMundo no WhatsApp! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatstecmundo - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsmegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JSpOKX 💡 Temos grupos também no Telegram! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JZoTbm - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegrammegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramthebrief CRÉDITOS Roteiro e apresentação: Wellington Arruda Imagens e áudio: Wellington Arruda Edição de vídeo: Rodrigo Doze Motion Graphics: Gustavo Silva A melhor programação está no TecMundo - História da Tecnologia - Entenda - Análises, Unboxings e tudo sobre Produtos! - TecDocs - Matérias especiais - Assistência Tec - Drops de Notícias - Listas - Hoje no TecMundo #Lexar #Computex2024 #ssd #TecMundo

Mini SSD Lexar SL400: setup profissional só com o celular #ssd #lexar

As melhores séries de ficção científica para assistir HOJE! #silo #Duna #Dunaaprofecia #MatériaEscura #Ficçãocientifica #dicasdeséries #appletv #Max

As 3 MELHORES séries RECENTES de Ficção Científica para assistir HOJE!

Dicas de Séries

A Xiaomi acabou de lançar os novos Redmi Note 14! Os novos Redmi Note 14 4G, Note 14 5G, Redmi Note 14 Pro e Note 14 Pro+ chegam ao Brasil com preços que vão de R$ 2,5 mil até R$ 6 mil. Extensão do TecMundo: encontre cupons escondidos nas principais lojas online: <a href="http://" target="_blank" rel="nofollow noopener">http://</a>bit.ly/3ZkKOji - Os melhores cupons Online para você! <a href="https://www." target="_blank" rel="nofollow noopener">https://www.</a>tecmundo.com.br/cupons 💡 Participe dos canais do TecMundo no WhatsApp! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatstecmundo - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsmegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/whatsminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JSpOKX 💡 Temos grupos também no Telegram! - TecMundo: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/3JZoTbm - Voxel: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramvoxel - Mega Curioso: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegrammegacurioso - Minha Série: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramminhaserie - The BRIEF: <a href="https://" target="_blank" rel="nofollow noopener">https://</a>bit.ly/telegramthebrief CRÉDITOS Roteiro e apresentação: Wellington Arruda Imagens e áudio: Gustavo Katsumi Edição de vídeo: Rafael Nogoceke Motion Graphics: Gustavo Silva A melhor programação está no TecMundo - História da Tecnologia - Análises, Unboxings e tudo sobre Produtos! - TecDocs - Matérias especiais - Assistência Tec - Lives de tradução e cobertura de eventos - Listas - Hoje no TecMundo #xiaomi #redmi #redminote14series #TecMundo

Redmi Note 14 lançado: câmera de 200 MP e até R$ 6 mil #xiaomi  #smartphone

Série de espionagem com Noah Centineo é a dica da vez para maratonar! A segunda temporada de Recruta chega em 30/jan na Netflix #noahCentineo #Recruta #Recruit #netflix #sériesnetflix #dicasdeséries

Série RECRUTA com Noah Centineo estreia hoje

Será que Karla Sofia Gascón pode perder a indicação ao Oscar pelas falas sobre a equipe de Fernanda Torres? Saiba mais sobre a polêmica aqui! #karlasofiagascon #oscar2025 #fernandatorres #oscars #aindaestouaqui #emiliaperez #polemica #treta #notícia #news #oscar

🚨Karla Sofia Gascón vai PERDER indicação ao OSCAR? #emiliaperez

Notícias sobre Filmes

Anora acabou de chegar aos cinemas e eu já assisti! Se você quer um filme divertido, mas com um toque de drama, esse é para você! #Anora #Oscar #filmesdoOscar #Dicasdefilmes #mikeyMadison

Dançarina erótica e herdeiro Russo, este é "ANORA": um conto de fadas destinado ao fracasso

Dicas de Filmes

#huawei #watchultimate #fashionedge [Tipo: Publieditorial]

IBM Node JS

Atualize o Appmetrics para executar no Node 12

Mais notícias sobre IBM Node JS