{"id":6513,"date":"2015-07-09T01:19:33","date_gmt":"2015-07-09T01:19:33","guid":{"rendered":"https:\/\/dev.railscarma.com\/understanding-the-asset-pipeline-plugin\/"},"modified":"2021-06-06T14:46:45","modified_gmt":"2021-06-06T14:46:45","slug":"comprendre-le-plugin-de-pipeline-dactifs","status":"publish","type":"post","link":"https:\/\/www.railscarma.com\/fr\/blog\/articles-techniques\/comprendre-le-plugin-de-pipeline-dactifs\/","title":{"rendered":"Comprendre le plugin Asset Pipeline"},"content":{"rendered":"
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tRuby on Rails ou simplement Rails est un merveilleux framework d'application Web, \u00e9crit en Ruby. Il fournit des services pour la conception d'une page Web. Il a remport\u00e9 les votes des geeks de la technologie pour ses services plus rapides en termes de d\u00e9veloppement d'un site Web en raison de ses fonctionnalit\u00e9s conviviales, de sa complexit\u00e9 r\u00e9duite et am\u00e9liorant ainsi son efficacit\u00e9 globale. L'une de ces fonctionnalit\u00e9s pour RoR est le pipeline d'actifs.\n

Le pipeline d'actifs est une fonctionnalit\u00e9 tr\u00e8s puissante propos\u00e9e par Rails, pour r\u00e9soudre un large \u00e9ventail de probl\u00e8mes li\u00e9s \u00e0 la conception Web.<\/p>\n

Il minimise les travaux manuels en compilant et en traitant toutes les feuilles de style, fichiers javascript, images, etc. autant que possible et se pr\u00e9pare \u00e0 l'utilisation. Le pipeline d'actifs peut am\u00e9liorer la qualit\u00e9 de l'application en termes de performances et de flexibilit\u00e9.<\/p>\n\n

<\/h3>\n

Le pipeline d'actifs\u00a0:<\/h3>\n

Le pipeline d'actifs fournit un cadre pour concat\u00e9ner et r\u00e9duire ou compresser les actifs JavaScript et CSS. Il ajoute \u00e9galement la possibilit\u00e9 d'\u00e9crire ces actifs dans d'autres langages et pr\u00e9processeurs tels que CoffeeScript, Sass et ERB.<\/p>\n

Le pipeline d'actifs n'est techniquement plus une fonctionnalit\u00e9 essentielle de Rails 4, il a \u00e9t\u00e9 extrait du framework dans le joyau sprockets-rails.<\/p>\n

Le pipeline d'actifs est activ\u00e9 par d\u00e9faut.<\/p>\n

Nous pouvons d\u00e9sactiver le pipeline d'actifs lors de la cr\u00e9ation d'une nouvelle application en passant l'option \u2013skip-sprockets.<\/p>\n

rails le nouveau nom de l'application -skip-sprockets<\/p>\n

Rails 4 ajoute automatiquement les gemmes sass-rails, coffee-rails et uglifier \u00e0 votre Gemfile, qui sont utilis\u00e9es par Sprockets pour la compression des actifs\u00a0:<\/p>\n

joyau 'sass-rails'<\/p>\n

gemme 'uglifier'<\/p>\n

joyau 'caf\u00e9-rails'<\/p>\n

L'utilisation de l'option \u2013skip-sprockets emp\u00eachera Rails 4 d'ajouter sass-rails et uglifier \u00e0 Gemfile, donc si vous souhaitez ult\u00e9rieurement activer le pipeline d'actifs, vous devrez ajouter ces gemmes \u00e0 votre Gemfile. De plus, la cr\u00e9ation d'une application avec l'option \u2013skip-sprockets g\u00e9n\u00e9rera un fichier config\/application.rb l\u00e9g\u00e8rement diff\u00e9rent, avec une instruction require pour le rail des pignons qui est comment\u00e9e. Vous devrez supprimer l'op\u00e9rateur de commentaire sur cette ligne pour activer ult\u00e9rieurement le pipeline d'actifs\u00a0:<\/p>\n

# n\u00e9cessite des \u00ab\u00a0pignons\/railtie\u00a0\u00bb<\/p>\n

Pour d\u00e9finir les m\u00e9thodes de compression des actifs, d\u00e9finissez les options de configuration appropri\u00e9es dans production.rb \u2013 config.assets.css_compressor pour votre CSS et config.assets.js_compressor pour votre JavaScript\u00a0:<\/p>\n

config.assets.css_compressor = :yui<\/p>\n

config.assets.js_compressor = :uglifier<\/p>\n\n

<\/h3>\n

Comment utiliser le pipeline d'actifs\u00a0:<\/h3>\n

Dans les versions pr\u00e9c\u00e9dentes de Rails, tous les actifs \u00e9taient situ\u00e9s dans des sous-r\u00e9pertoires publics tels que les images, les javascripts et les feuilles de style. Avec le pipeline d'actifs, l'emplacement privil\u00e9gi\u00e9 pour ces actifs est d\u00e9sormais le r\u00e9pertoire app\/assets. Les fichiers de ce r\u00e9pertoire sont servis par le middleware Sprockets.<\/p>\n

Les actifs peuvent toujours \u00eatre plac\u00e9s dans la hi\u00e9rarchie publique. Tous les actifs sous public seront servis sous forme de fichiers statiques par l'application ou le serveur Web lorsque config.serve_static_files est d\u00e9fini sur true. Vous devez utiliser app\/assets pour les fichiers qui doivent subir un pr\u00e9traitement avant d'\u00eatre servis.<\/p>\n

En production, Rails pr\u00e9compile ces fichiers en public\/assets par d\u00e9faut. Les copies pr\u00e9compil\u00e9es sont ensuite servies comme ressources statiques par le serveur Web. Les fichiers dans app\/assets ne sont jamais servis directement en production.<\/p>\n\n

Actifs sp\u00e9cifiques au contr\u00f4leur\u00a0:<\/h3>\n

Lorsque vous g\u00e9n\u00e9rez un \u00e9chafaudage ou un contr\u00f4leur, Rails g\u00e9n\u00e8re \u00e9galement un fichier JavaScript (ou un fichier CoffeeScript si la gemme coffee-rails est dans le Gemfile) et un fichier de feuille de style en cascade (ou un fichier SCSS si sass-rails est dans le Gemfile) pour ce contr\u00f4leur. De plus, lors de la g\u00e9n\u00e9ration d'un \u00e9chafaudage, Rails g\u00e9n\u00e8re le fichier scaffolds.css (ou scaffolds.css.scss si sass-rails se trouve dans le Gemfile.)<\/p>\n

Par exemple, si vous g\u00e9n\u00e9rez un ProjectsController, Rails ajoutera \u00e9galement un nouveau fichier dans app\/assets\/javascripts\/projects.js.coffee et un autre dans app\/assets\/stylesheets\/projects.css.scss. Par d\u00e9faut, ces fichiers seront imm\u00e9diatement pr\u00eats \u00e0 \u00eatre utilis\u00e9s par votre application \u00e0 l'aide de la directive require_tree. Voir Fichiers manifestes et directives pour plus de d\u00e9tails sur require_tree.<\/p>\n

Vous pouvez \u00e9galement choisir d'inclure des feuilles de style et des fichiers JavaScript sp\u00e9cifiques au contr\u00f4leur uniquement dans leurs contr\u00f4leurs respectifs en utilisant les \u00e9l\u00e9ments suivants\u00a0:<\/p>\n

<%= javascript_include_tag params[:controller] %> ou <%= stylesheet_link_tag params[:controller] %><\/p>\n\n

Actifs de pr\u00e9compilation\u00a0:<\/h3>\n

Rails est livr\u00e9 avec une t\u00e2che rake pour compiler les manifestes d'actifs et d'autres fichiers dans le pipeline.<\/p>\n

Les actifs compil\u00e9s sont \u00e9crits \u00e0 l'emplacement sp\u00e9cifi\u00e9 dans config.assets.prefix. Par d\u00e9faut, il s'agit du r\u00e9pertoire \/assets.<\/p>\n

Vous pouvez appeler cette t\u00e2che sur le serveur lors du d\u00e9ploiement pour cr\u00e9er des versions compil\u00e9es de vos actifs directement sur le serveur. Voir la section suivante pour plus d'informations sur la compilation locale.<\/p>\n

La t\u00e2che de r\u00e2teau est\u00a0:<\/p>\n

$ RAILS_ENV=actifs du bac de production\/rake\u00a0: pr\u00e9compiler<\/p>\n

Capistrano (v2.15.1 et sup\u00e9rieur) inclut une recette pour g\u00e9rer cela lors du d\u00e9ploiement. Ajoutez la ligne suivante \u00e0 Capfile\u00a0:<\/p>\n

charger 'd\u00e9ployer\/actifs'<\/p>\n

Cela lie le dossier sp\u00e9cifi\u00e9 dans config.assets.prefix \u00e0 shared\/assets. Si vous utilisez d\u00e9j\u00e0 ce dossier partag\u00e9, vous devrez \u00e9crire votre propre t\u00e2che de d\u00e9ploiement.<\/p>\n

Il est important que ce dossier soit partag\u00e9 entre les d\u00e9ploiements afin que les pages mises en cache \u00e0 distance faisant r\u00e9f\u00e9rence aux anciennes ressources compil\u00e9es fonctionnent toujours pendant toute la dur\u00e9e de vie de la page mise en cache.<\/p>\n\n

Compilation en direct\u00a0:<\/h3>\n

Dans certaines circonstances, nous souhaiterons peut-\u00eatre utiliser la compilation en direct. Dans ce mode, toutes les demandes d'actifs dans le pipeline sont trait\u00e9es directement par Sprockets.<\/p>\n

Pour activer cette option, d\u00e9finissez\u00a0:<\/p>\n

config.assets.compile = vrai<\/p>\n

\u00c0 la premi\u00e8re demande, les actifs sont compil\u00e9s et mis en cache comme indiqu\u00e9 dans le d\u00e9veloppement ci-dessus, et les noms de manifeste utilis\u00e9s dans les assistants sont modifi\u00e9s pour inclure le hachage MD5.<\/p>\n

Sprockets d\u00e9finit \u00e9galement l'en-t\u00eate HTTP Cache-Control sur max-age=31536000. Cela signale \u00e0 tous les caches entre votre serveur et le navigateur client que ce contenu (le fichier servi) peut \u00eatre mis en cache pendant 1 an. Cela a pour effet de r\u00e9duire le nombre de requ\u00eates pour cet actif depuis votre serveur\u00a0; l'actif a de bonnes chances de se trouver dans le cache du navigateur local ou dans un cache interm\u00e9diaire.<\/p>\n

Ce mode utilise plus de m\u00e9moire, fonctionne moins bien que le mode par d\u00e9faut et n'est pas recommand\u00e9.<\/p>\n

Si vous d\u00e9ployez une application de production sur un syst\u00e8me sans environnement d'ex\u00e9cution JavaScript pr\u00e9existant, vous souhaiterez peut-\u00eatre en ajouter un \u00e0 votre Gemfile\u00a0: group\u00a0:production do<\/p>\n

gemme 'therubyracer'<\/p>\n

fin<\/p>\n

Railscarma a mis en \u0153uvre Ruby on Rails depuis ses d\u00e9buts pour le d\u00e9veloppement, la formation, le d\u00e9ploiement et la contribution \u00e0 la communaut\u00e9 Rails et offre le meilleur Services de d\u00e9veloppement Ruby on Rails<\/a>. RailsCarma fournit des services Ruby on Rails de bout en bout, notamment du conseil, de l'architecture, de la construction, de la gestion et de l'extension, aux entreprises du monde entier. Vous pouvez \u00e9galement embaucher des d\u00e9veloppeurs Ruby on Rails gr\u00e2ce \u00e0 un processus d'embauche simple.Contactez-nous<\/a> en savoir plus.<\/p>\n

En savoir plus :\u00a0<\/em><\/p>\n\n