Configuration de l'accès
Ce document détaille les outils nécessaires et les conditions d'accès pour utiliser les AxeDevTools
gemmes.
Exigences
Voici les exigences pour le développement Ruby avec les ** gemmes axe DevTools** :
- [Ruby][] avec une version supérieure à 2.6.0.
- [Bundler][]
En option, nous vous recommandons d'installer tous les pilotes Web du navigateur, comme [geckodriver][], pour une utilisation par les gemmes axe DevTools qui prennent en charge les pilotes Web.
Configuration de l'accès
Vous devez avoir accès au registre Deque Systems. Si vous n'avez pas encore accès, veuillez contacter le service d'assistance de Deque Systems
Suivez [ces instructions de configuration pour accéder au registre de Deque][configuration du registre npm d'attest] afin que les gemmes axe DevTools puissent être installées et utilisées.
En option, après avoir obtenu l'accès au registre Deque Systems, nous vous recommandons de configurer votre configuration de bundle par défaut pour qu'elle pointe vers le registre comme suit :
bundle config agora.dequecloud.com <username>:<identitytoken>
Vous pouvez alors utiliser les gems directement sans source :
gem "axe-devtools-cucumber"
Alternativement, vous pouvez spécifier une source pour la gem :
gem "axe-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'
Choisissez les Gems et intégrez-les
Après avoir configuré l'accès au référentiel Deque, choisissez une gem dans le framework de test et dans le WebDriver et commencez l'intégration.
Veuillez vous référer à la [documentation respective de chaque gem][] pour des instructions détaillées sur l'installation, l'utilisation et la documentation de l'API.
Un exemple d’extrait de code d’intégration est présenté ci-dessous :
# Choose a testing framework
require "axe-rspec"
# choose a WebDriver
require "axe-capybara"
# configure WebDriver
AxeCapybara.configure(:firefox) do |c|
# ...
end
# write tests
# ...
expect(page).to be_axe_clean
[ruby] : https://www.ruby-lang.org/en/ [bundler] : https://bundler.io/ [geckodriver] : https://github.com/mozilla/geckodriver [attest npm registry setup] : https://dequeuniversity.com/guide/attest/2.11/getting-started/npm-setup/ [documentation respective pour chaque gem] : rb-introduction#axe-devtools-gems