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 |
|
22 | # Contributing to Apache Cordova
|
23 |
|
24 | Anyone can contribute to Cordova. And we need your contributions.
|
25 |
|
26 | There are multiple ways to contribute: report bugs, improve the docs, and
|
27 | contribute code.
|
28 |
|
29 | For instructions on this, start with the
|
30 | [contribution overview](http://cordova.apache.org/contribute/).
|
31 |
|
32 | The details are explained there, but the important items are:
|
33 | - Sign and submit an Apache ICLA (Contributor License Agreement).
|
34 | - Have a Jira issue open that corresponds to your contribution.
|
35 | - Run the tests so your patch doesn't break existing functionality.
|
36 |
|
37 | We look forward to your contributions!
|
38 |
|
39 | The notes on [Commit Workflow](https://github.com/apache/cordova-coho/blob/master/docs/committer-workflow.md#commit-workflow) can be helpful even if you are not a committer.
|
40 |
|
41 | ## Running plugin tests
|
42 |
|
43 | * clone and install [cordova-plugin-test-framework](https://github.com/apache/cordova-plugin-test-framework)
|
44 | ```
|
45 | git clone git@github.com:apache/cordova-plugin-test-framework.git
|
46 | ```
|
47 | * edit ```cordova-plugin-test-framework/www/assets/index.html``` and add the following line
|
48 | ```
|
49 | <meta http-equiv="Content-Security-Policy" content="default-src 'self' data: gap: https://ssl.gstatic.com http://cordova.apache.org http://google.co.uk https://google.co.uk 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *">
|
50 | ```
|
51 | * create test project
|
52 | ```
|
53 | cordova create plugintest
|
54 | cd plugintest
|
55 | cordova platform add android
|
56 | cordova plugin add ../cordova-plugin-inappbrowser
|
57 | cordova plugin add ../cordova-plugin-inappbrowser/tests
|
58 | cordova plugin add ../cordova-plugin-test-framework
|
59 | ```
|
60 | * edit ```config.xml``` and replace ```<content src="index.html" />``` with ```<content src="cdvtests/index.html" />```
|
61 | * run application
|
62 | ```
|
63 | cordova run
|
64 | ```
|
65 |
|
\ | No newline at end of file |