← Back to branch summary

~nskaggs/help-app/functional-test-template

« back to all changes in this revision

Viewing changes to HACKING

  • Committer: Daniel Holbach
  • Date: 2015-04-08 12:34:32 UTC
  • mto: This revision was merged to the branch mainline in revision 135.
  • Revision ID: daniel.holbach@canonical.com-20150408123432-a5ctzpsv95pcponz
split out link checking functionality into utils.py

Show diffs side-by-side

added added

removed removed

Lines of Context:
HACKING
86
86
 
87
87
  sudo apt install python-pelican po4a make bzrtools \
88
88
        ubuntu-html5-ui-toolkit python3-polib python3-magic \
89
 
        python3-markdown pep8 pyflakes python-magic python-polib
 
89
        python3-markdown pep8 pyflakes
90
90
 
91
91
This will install the necessary files, so you can build the app or web build
92
92
locally and check if your changes actually make sense and look and work well.
163
163
 
164
164
        make check
165
165
 
166
 
Functional (autopilot / selenium) tests
167
 
---------------------------------------
168
 
 
169
 
Make sure that you have oxide-chromedriver and selenium installed:
170
 
 
171
 
    sudo apt-get install oxideqt-chromedriver
172
 
    sudo apt-add-repository ppa:canonical-platform-qa/selenium
173
 
    sudo apt-get update
174
 
    sudo apt-get install python3-selenium
175
 
 
176
 
Run the tests:
177
 
 
178
 
    cd internals/tests/functional
179
 
    autopilot3 list help_app
180
 
    autopilot3 run help_app
181
 
 
182
 
Debugging
183
 
---------
184
 
 
185
 
Did you find a bug and you're not sure how to debug it? 
186
 
 
187
 
Adding DEBUG=1 to the make command will give you additional information
188
 
in a few cases. For example will 
189
 
 
190
 
 - pelican print out debug information, which is very useful if you
191
 
   are changing pelican configuration options or are playing around
192
 
   with markdown extensions.
193
 
 - 'make launch' add the --inspector argument to ubuntu-html5-app-launcher. 
194
 
   This will allow you to point your webkit-enabled browser to  
195
 
    http://<yourip>:9221  
196
 
   to examine some of the web attributes of the app.
197
 
  
198
 
 
199
166
Running the app on a phone
200
167
--------------------------
201
168