Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
content:servalmesh:development [25/08/2013 22:37] Andrew Bettison [Source code] link to internal pages |
content:servalmesh:development [14/02/2016 19:14] Andrew Bettison Add [Alpha and Beta releases] section |
====== Instructions for developing Serval Mesh ====== | ====== Serval Mesh development ====== |
| |
==== Overview ==== | ==== Overview ==== |
To contribute code or documentation to [[.:|Serval Mesh]], please observe the Serval Project's [[:content:dev:|Software Development]] practices and refer to this page for procedures and resources that pertain specifically to Serval Mesh. | To contribute code or documentation to [[.:|Serval Mesh]], please observe the Serval Project's [[:content:dev:|Software Development]] practices and refer to this page for procedures and resources that pertain specifically to Serval Mesh. |
| |
==== Copyright and Licensing ==== | ==== Copyright ==== |
| |
Copyright in all Batphone source code (including technical documentation) is owned by [[content:spi]]. Contributors must assign their copyright to [[content:spi]] by furnishing a signed [[content:dev:|Developer Agreement]]. The Batphone source code is licensed to the public under the terms of the [[http://www.gnu.org/licenses/gpl.html|GNU General Public License, version 3]]. | Copyright in all Batphone source code (including technical documentation) is either owned by [[content:spi]] or is owned by its author and licensed to the public under [[:content:dev:#copyright|non restrictive terms]]. Contributors can assign copyright to [[content:spi]] by furnishing a signed [[content:dev:|Developer Agreement]]. |
| |
See [[:content:servaldna:development#copyright_and_licensing|Serval DNA Copyright and Licensing]] for information about Serval DNA. | See [[:content:servaldna:development#copyright|Serval DNA Copyright]] for information about Serval DNA. |
| |
| ==== Licensing ==== |
| |
| The Batphone source code is licensed to the public under the terms of the [[http://www.gnu.org/licenses/gpl.html|GNU General Public License, version 3]]. |
| |
| See [[:content:servaldna:development#licensing|Serval DNA Licensing]] for information about Serval DNA. |
| |
==== Source code ==== | ==== Source code ==== |
| |
The Batphone source code and accompanying technical documentation is held in the [[Batphone Git repository]], which contains two main branches: | The Batphone source code and accompanying [[:content:dev:techdoc|technical documentation]] are controlled using [[:content:dev:git]] and held in the [[Batphone Git repository]], which contains two main branches: |
- The head of the [[Git master branch]] is always the [[.:release:|latest public release]]. Each release is tagged with its [[version numbering|version number]], for example [[https://github.com/servalproject/batphone/tree/0.08|0.08]], [[https://github.com/servalproject/batphone/tree/0.90|0.90]]. | - The head of the [[Git master branch]] is always the [[.:release:|latest public release]]. Each release is tagged with its [[version numbering|version number]], for example [[https://github.com/servalproject/batphone/tree/0.08|0.08]], [[https://github.com/servalproject/batphone/tree/0.90|0.90]]. |
- The [[Git development branch]] holds code that is intended for the next release. All commits on this branch should build cleanly (no warnings), and install and run okay. | - The [[Git development branch]] holds code that is intended for the next release. All commits on this branch should build cleanly (no warnings), and install and run okay. |
| |
The [[sampler|Serval Mesh Sampler]] application contains examples of how to use the [[.:api:|Serval Mesh APIs]]. | The [[sampler|Serval Mesh Sampler]] application contains examples of how to use the [[.:api:|Serval Mesh APIs]]. |
| |
| ==== Alpha and Beta releases ==== |
| |
| The Serval Mesh app is available for //open Beta testing// on Google Play, so anybody with a Google account can install and test the latest Beta version. Furthermore, members of the [[https://groups.google.com/forum/#!forum/serval-project-developers|serval-project-developers]] Google group can test the Alpha version. |
| |
| - Sign in to Google (requires a Google account) |
| - To install the most recent **Alpha** or **Beta** version, join the [[https://groups.google.com/forum/#!forum/serval-project-developers|serval-project-developers]] Google group; to install only the latest **Beta** version, do not join that group |
| - Go to the [[https://play.google.com/apps/testing/org.servalproject]] opt-in page and sign up as a Tester |
| - Install the [[https://play.google.com/store/apps/details?id=org.servalproject|Serval Mesh app from Google Play]] -- the Alpha or Beta version will be installed |
| |
==== Testing and Quality Assurance ==== | ==== Testing and Quality Assurance ==== |
==== Releasing ==== | ==== Releasing ==== |
| |
Follow the **[[.:release:|release procedure]]** to make a new release of the Serval Mesh software. | Follow the **[[.:release:|Serval Mesh release procedure]]** to make a new release of the Serval Mesh app. |
| |
Learn about about Serval Mesh [[version numbering|version numbering]]. | |
| |
See the [[:content:servalmesh:releases:|full list of Serval Mesh releases]]. | * Learn about about Serval Mesh [[version numbering|version numbering]]. |
| * See the [[:content:servalmesh:releases:|full list of Serval Mesh releases]]. |
| |
==== Bug tracking ==== | ==== Bug tracking ==== |