~cordova-ubuntu/cordova-ubuntu-tests/ci

« back to all changes in this revision

Viewing changes to www/README.md

  • Committer: VĂ­ctor R. Ruiz
  • Date: 2013-07-25 13:09:34 UTC
  • Revision ID: victor.ruiz@canonical.com-20130725130934-d4q95mh8eehbv363
Initial import

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!--
 
2
#
 
3
# Licensed to the Apache Software Foundation (ASF) under one
 
4
# or more contributor license agreements.  See the NOTICE file
 
5
# distributed with this work for additional information
 
6
# regarding copyright ownership.  The ASF licenses this file
 
7
# to you under the Apache License, Version 2.0 (the
 
8
# "License"); you may not use this file except in compliance
 
9
# with the License.  You may obtain a copy of the License at
 
10
 
11
# http://www.apache.org/licenses/LICENSE-2.0
 
12
 
13
# Unless required by applicable law or agreed to in writing,
 
14
# software distributed under the License is distributed on an
 
15
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 
16
#  KIND, either express or implied.  See the License for the
 
17
# specific language governing permissions and limitations
 
18
# under the License.
 
19
#
 
20
-->
 
21
## Mobile Spec Suite ##
 
22
 
 
23
These specs are designed to run inside the mobile device that implements it - _it will fail in the DESKTOP browser_.
 
24
 
 
25
These set of tests is designed to be used with Cordova. You should initialize a fresh Cordova repository for a target platform and then toss these files into the www folder, replacing the
 
26
contents. 
 
27
 
 
28
Make sure you include cordova.js in the www folder (see the code in cordova-incl.js for clarification).
 
29
 
 
30
This is done so that you don't have to modify every HTML file when you want to test a new version of Cordova.
 
31
 
 
32
The goal is to test mobile device functionality inside a mobile browser.
 
33
Where possible, the Cordova API lines up with HTML 5 spec. Maybe down
 
34
the road we could use this spec for parts of HTML 5, too :)
 
35
 
 
36
### Requirements ###
 
37
 
 
38
Various parts of this test suite communicate with external servers.
 
39
Therefore, when you wrap up the test suite inside a Cordova application,
 
40
make sure you add the following entries to the whitelist!
 
41
 
 
42
- audio.ibeat.org
 
43
- cordova-filetransfer.jitsu.com
 
44
- whatheaders.com
 
45
- apache.org (with all subdomains)
 
46
- www.google.com
 
47
- httpssss://example.com (bad protocol necessary)
 
48