Différences

Ci-dessous, les différences entre deux révisions de la page.

--- prog:emscripten [2021/07/24 20:41] – [WebAssembly.instantiateStreaming en TypeScript] : ne pas compiler avec le support de node.js afin de réduire les dépendances et la taille du code root
+++ prog:emscripten [2022/07/18 12:49] (Version actuelle) – [Compilation] : ajout de "Pour le debug" root
@@ Ligne 1: / Ligne 1: @@
-=====Téléchargement et installation=====
+=====Téléchargement et installation et mise à jour=====
 <code bash>
 git clone --depth 1 https://github.com/emscripten-core/emsdk.git
@@ Ligne 19: / Ligne 19: @@
 [[https://pascalpares.appspot.ovh/webassembly-for-javascript-developers/|An Introduction to WebAssembly for JavaScript Developers]] {{ :prog:emscripten:an_introduction_to_webassembly_for_javascript_developers_2021-07-24_11_04_06_.html |Archive du 21/04/2021 le 24/07/2021}}
+[[https://developers.google.com/web/updates/2018/03/emscripting-a-c-library|Emscripting a C library to Wasm]] {{ :prog:emscripten:emscripting_a_c_library_to_wasm_web_google_developers_8_4_2021_10_04_21_am_.html |Archive du 31/07/2020 le 04/08/2021}}
 ====Compilation====
@@ Ligne 24: / Ligne 25: @@
 Liste des [[https://github.com/emscripten-core/emscripten/blob/main/src/settings.js|settings]] (''-s'').
+Pour réduire la taille du wrapper:
+  * ''-s ENVIRONMENT=web,worker'' : réduire les fonctionnalités en supprimant le support de node.js. Réduit très légèrement la taille du wrapper mais enlève des dépendances externes. Utile pour la mise en production dans un projet Angular. Ne doit pas être enlevé si les tests exécutés par node.js,
+  * ''%%--%%closure 1 -s MODULARIZE=1'' : ''closure'' fait de la minification. Afin d'éviter les effets de bord avec d'autres variables globales en Javascript, il est forcement recommandé d'encapsuler le code dans un module,
+  * ''%%--no-entry%%'' : désactive la fonction ''main'' qui est inutile si la sortie Javascript est une librairie et non une application indépendante,
+  * ''-s ASSERTIONS=0'' : désactive des sécurités.
+Pour réduire la taille du wasm:
+  * ''-flto'' : active l'optimisation globale du lieur,
+  * ''-DNDEBUG'' : désactive le debug. N'impacte pas le code emscripten mais uniquement le code utilisateur,
+  * ''-Oz'' : le bytecode est optimisé pour réduire la taille.
+  * ''-s MALLOC=%%'emmalloc'%%'' : utilise une version de malloc réduite en fonctionnalité mais spécifique à emscripten.
+Pour le debug:
+  * ''-O0'' : aucune optimisation.
+  * ''-g'' : toutes les informations de débogage,
+  * ''-s ASSERTIONS=2'' : toutes les assertions à l'exécution,
+  * ''-s DEMANGLE_SUPPORT=1'' : affichage des symboles en cas d'affichage de la trace par le compilateur,
+  * ''%%--%%emit-symbol-map'' : génère un fichier ''.map'',
+  * ''-gsource-map'' : génère un ''.map'' compatible LLVM pour déboguer avec Chrome,
+  * ''%%--source-map-base http://localhost:4200/assets/%%'' : codage en dur du chemin vers le fichier ''.wasm'' uploadé et non du chemin dans l'ordinateur.
+Pour mémo, le tableau des résultats. La comparaison des options ''-Ox'' se fait par rapport à ''-O0''. Puis, les options suivantes s'accumulent avec l'option -Oz. Dans mon cas, ''-O2'' réduit mieux la taille que ''-Oz''. A confirmer sur de plus gros projets.
+^Option^gros js^gros wasm^petit js^petit wasm^gros js^gros wasm^petit js^petit wasm^
+|''-O0''|349801|888030|217442|59279|-|-|-|-|
+|''-O2''|349801|841160|214892|26971|0%/0o|-5,3%/-46870o|-1,2%/-2550o|-54,5%/-32308o|
+|''-O3''|349801|841966|214892|26971|0%/0o|-5,2%/-46064o|-1,2%/-2550o|-54,5%/-32308o|
+|''-Os''|349801|842814|217442|34746|0%/0o|-5,1%/-45216o|0%/0o|-41,4%/-24533o|
+|''-Oz''|349801|842838|217442|34739|0%/0o|-5,1%/-45192o|0%/0o|-41,4%/-24540o|
+|''-s ENVIRONMENT=web,worker''|N/A|N/A|214984|34739|N/A|N/A|-1,1%/-2458o|0%/0o|
+|''%%--%%closure 1''|158780|842838|118137|34739|-54,6%/-191021o|0%/0o|-45%/-96847o|0%/0o|
+|''%%--%%no-entry''|158223|842838|117580|34739|-0,4%/-557o|0%/0o|-0,5%/-557o|0%/0o|
+|''-flto''|158223|835253|117580|31867|0%/0o|-0,9%/-7585o|0%/0o|-8,3%/-2872o|
+|''-s ASSERTIONS=0''|67927|835110|34944|31510|-57,1%/-90296o|0%/-143o|-70,3%/-82636o|-1,1%/-357o|
+|''-DNDEBUG''|67927|835110|34944|31510|0%/0o|0%/0o|0%/0o|0%/0o|
+|''-s INVOKE_RUN=0''|67927|835110|34944|31510|0%/0o|0%/0o|0%/0o|0%/0o|
+|''-s MALLOC='emmalloc%%'%%''|67927|826803|34944|23703|0%/0o|-1%/-8307o|0%/0o|-24,8%/-7807o|
 ====vcpkg====
@@ Ligne 277: / Ligne 318: @@
 Il est possible que le compilateur râle si on utilise des fonctionnalités de type bindings.
-Si la compatibilité avec node.js n'est pas indispensable, on peut tout simplement désactiver via l'option de compilation ''-s ENVIRONMENT=worker''. Cette option ne réduit pas la taille du fichier ''.wasm'' et seulement de façon marginal le ''.js'' mais cela enlève les dépendances spécifiques à ''node.js''.
+<WRAP center round info 60%>
+Si la compatibilité avec node.js n'est pas indispensable, on peut tout simplement désactiver via l'option de compilation ''-s ENVIRONMENT=web,worker''. Cette option ne réduit pas la taille du fichier ''.wasm'' et seulement de façon marginal le ''.js'' mais cela enlève les dépendances spécifiques à ''node.js''.
+</WRAP>
 <code>
@@ Ligne 323: / Ligne 366: @@
 Dans ce cas, il faut désactiver le module. Les fonctions associées ne fonctionneront pas.
+<WRAP center round info 60%>
+Il se peut que la compatibilité soient nécessaires pour les tests qui nécessitent node.js pour s'exécuter mais que TypeScript ne nécessite pas ces dépendances. Il est possible de tout désactiver pour TypeScript en les mettant tous à ''false'' dans la rubrique ''browser'' ci-dessous et sans installer les dépendances via ''npm''.
+</WRAP>
 <file javascript package.json>