Tutorials

This is a list of tutorials for developers that they'd like to contribute on/develop with Fieldtrip Open framework.

List of tutorials:

• Fire up a basic FOpen app

Tutorials

Fire up a basic FOpen app

The Fieldtrip Open framework is being defined by the diagram below:

https://docs.google.com/drawings/d/1j4RQ4oAaNQhRn2nGWfwGXIsO4itcaAAKgTyXWP9MsiA/edit?usp=sharing

As you can see from the image the project is the one that defines the theme and the plugins that will be included on the final apk. Let's go and create our own project.

• Create my own project:

git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:panterz/fieldtrip-panos-example.git
git push -u origin master

• Add the fieldtrip project structure

.
├── platforms
│   └── android
│       └── res
├── src
└── theme

• First of all you need to clone fieldtrip-open project on your local machine:

git clone git@github.com:edina/fieldtrip-open.git
cd fieldtrip-open

• You need to add a configuration file that will define different variables such as pcapi url, name of the app etc

[common]

url=<pcapi-url>
[install]

; name of the project
name=COBWEB

; the source of this file
location=<user>@<server>:~/config/cobweb.ini
location_port=22

; git repository of project
project=git@github.com:edina/fieldtrip-cobweb.git

; the install directory
runtime_dir=cobweb

;details for config.xml
author_email=edina@ed.ac.uk
access_urls=http://a.tile.openstreetmap.org,http://b.tile.openstreetmap.org,http://c.tile.openstreetmap.org,http://a.tile.opencyclemap.org,http://b.tile.opencyclemap.org,http://c.tile.opencyclemap.org
url=<url>

[release]

; the public release root URL
url=<url where apps are published>

; accounts and machine names hosting the release
hosts=<user>@<server>
port=22

; keystore for signing offical releases
keystore_location=user@<server>:~/config                
keystore_name=opal

; the filesystem directory holding releases
dir=/home/cobweb/dist/mobile_app

; email notification details
smtp=smtp.staffmail.ed.ac.uk
sender=cobwebpartners@mlist.is.ed.ac.uk

; notified of beta release
email_beta=cobwebpartners@mlist.is.ed.ac.uk

; notified of official release
email_official=p.terzis@ed.ac.uk

[pcapi]
version=1.3
url=${common:url}
providers=local,
anonymous_user=2338e388-f34e-25d9-945c-54cffd9c46c2


; the values in the app section becomes config.js in the application
; underscores must not be used in variables names in this section
[app]

; use end user license dialog?
enduserlicence=true

; map_baselayer - current supported osm or ftgb
mapBaseLayer=osm
mapUrl=http://a.tile.openstreetmap.org
pcapiversion=${pcapi:version}
pcapiurl=${pcapi:url}
pcapiproviders=${pcapi:providers}
pcapianonymous=${pcapi:anonymous_user}

; the java package of the abndroid application
package=uk.ac.edina.cobweb

; priviliged users
priviligedUsers=<phone uuids>

; URL of the project home page
weburl=${common:url}

; testing user account
testclouduser=<email>
testcloudpass=un5afe

; some gps tracking options
gotomapaftergpssave=true

; export data automatically
ogcsync=true

;path for private users' editors
formsPath=surveys

;default locations
defaultLocations = {"en-GB": {"lon": -2.421976, "lat": 53.825564}, "el-GR": {"lon": 22.480302, "lat": 40.106240}, "de-DE": {"lon": 8.
359222, "lat": 53.823354}}

;basemap cache limit
cacheLimit = 4194304000

; details for mapserver urls
[settings]
offline-maps = {"osm": "http://a.tile.openstreetmap.org", "cyclemap": "http://a.tile.opencyclemap.org/cycle"}

; details for pcapi urls
sync = {"envsys": "${common:url}", "cobweb": "<new url>"}