Skip to main content
This revision made August 11, 2011 17:48, by Fabrizio Giudici
« earlier revision revert to this « later revision

blueBill







This page has been moved - please go to http://bluebill.tidalwave.it/mobile/development/.

Difference compared to previous revision
<span>[[image: blueBill_icon_for_JavaNet.png|left]] = blueBill = <span style="text-decoration:line-through;color:red">Hello. </span>This <span style="text-decoration:line-through;color:red">is the blueBill </span>p<span style="text-decoration:line-through;color:red">roject. These p</span>age<span style="text-decoration:line-through;color:red">s</span> <span style="text-decoration:line-through;color:red">are for developers only; t</span>h<span style="text-decoration:line-through;color:red">e web site for users is </span>a<span style="text-decoration:line-through;color:red">t [http://bluebill.tidalwave.it]. ==Getting the </span>s<span style="text-decoration:line-through;color:red">ources</span> <span style="text-decoration:line-through;color:red">== The project is composed of three independent parts: # '''</span>b<span style="text-decoration:line-through;color:red">lu</span>e<span style="text-decoration:line-through;color:red">Bill Mobil</span><span style="text-decoration:line-through;color:red"> for A</span>n<span style="text-decoration:line-through;color:red">droid'''.</span> <span style="text-decoration:line-through;color:red">It's the application running on Android s</span>m<span style="text-decoration:line-through;color:red">artph</span>o<span style="text-decoration:line-through;color:red">nes. # '''blueBill Core'''. It's a library of required APIs. # '''blueBill Resources Generator'''. It's a set of offline procedures able to create resources used by blueBill Mobile for Android. The build tool is Ma</span>ve<span style="text-decoration:line-through;color:red">n 3.0.2. The issue tracker is at: * [https://services.ti</span>d<span style="text-decoration:line-through;color:red">alwave.it/jira/browse/BBMA] *</span> <span style="text-decoration:line-through;color:red">[https://services.tidalwave.it/jira/browse/BBC] * [https://services.tidalwave.it/jira/browse/BBR] The project is under Continuous Integration at [http://hudson.tidalwave.it/hudson/view/blueBill/]. To retrieve the sources, you need Mercurial: hg clone https://java.net/hg/bluebill</span>-<span style="text-decoration:line-through;color:red">mobile~android-src </span> <span style="text-decoration:line-through;color:red">hg clone htt</span>p<span style="text-decoration:line-through;color:red">s://java.net/hg/b</span>l<span style="text-decoration:line-through;color:red">u</span>e<span style="text-decoration:line-through;color:red">bill~core-src hg clone https://j</span>a<span style="text-decoration:line-through;color:red">va.net/hg/bluebill~re</span>s<span style="text-decoration:line-through;color:red">ourc</span>e<span style="text-decoration:line-through;color:red">s-src It</span> <span style="text-decoration:line-through;color:red">should be possible to build the project on any operatin</span>g<span style="text-decoration:line-through;color:red"> system where the Java and the Andr</span>o<span style="text-decoration:line-through;color:red">id</span> to<span style="text-decoration:line-through;color:red">ols</span> <span style="text-decoration:line-through;color:red">are available. It has been actually tested only on Linux and Mac OS X 10.5+, with a Java 6 JDK. To build any project just run from the command line: mvn clean install -DskipTests It is possible to use any IDE with Maven support. The preferred ones are </span>[http://<span style="text-decoration:line-through;color:red">www.net</span>b<span style="text-decoration:line-through;color:red">eans.org NetBeans] and Inte</span>l<span style="text-decoration:line-through;color:red">liJ IDEA; [http://www.eclipse.org Eclipse] can also be </span>u<span style="text-decoration:line-through;color:red">s</span>e<span style="text-decoration:line-through;color:red">d. A quick overview of the structure of the project is availa</span>b<span style="text-decoration:line-through;color:red">le [[Structure|here]]. == Contr</span>i<span style="text-decoration:line-through;color:red">buting to the project == If you want to contribute to the project, p</span>l<span style="text-decoration:line-through;color:red">ease get in touch by means of the deve</span><span style="text-decoration:line-through;color:red">oper mailing list</span>.<span style="text-decoration:line-through;color:red"> In order </span>t<span style="text-decoration:line-through;color:red">o contr</span>i<span style="text-decoration:line-through;color:red">bute co</span>d<span style="text-decoration:line-through;color:red">e, you need to send us </span>a<span style="text-decoration:line-through;color:red"> signed copy of the Tida</span>lwave<span style="text-decoration:line-through;color:red"> Individual Contributor License Agreement (ICLA) - it's available in the sources of the project, under the 'docs' directory</span>.<span style="text-decoration:line-through;color:red"> Th</span>i<span style="text-decoration:line-through;color:red">s burocra</span>t<span style="text-decoration:line-through;color:red">ic step is needed for you, us and the blueBill users in order to guarantee that the project will be always available under the current licensing ter</span>[[image: blueBill_icon_for_JavaNet.png|left]] = blueBill = ... This page has been moved - please go to [http://bluebill.tidalwave.it<span style="text-decoration:underline;color:green">/</span>m<span style="text-decoration:line-through;color:red">s. === Internati</span>o<span style="text-decoration:line-through;color:red">nalization === </span>b<span style="text-decoration:line-through;color:red">lueB</span>il<span style="text-decoration:line-through;color:red">l aims at providing int</span>e<span style="text-decoration:line-through;color:red">rnationalize</span>mobile<span style="text-decoration:underline;color:green">/</span>d<span style="text-decoration:line-through;color:red"> v</span>e<span style="text-decoration:line-through;color:red">rsions for many languages. This feature needs constant help from mother-language writers from around the world. More information about the process are [[Internationalization|here]]. == Getting started == Please ha</span>ve<span style="text-decoration:line-through;color:red"> a read of the [[CodingGuide</span>l<span style="text-decoration:line-through;color:red">ines|C</span>o<span style="text-decoration:line-through;color:red">ding Guidelines]] before you look at the sources. The two most im</span>p<span style="text-decoration:line-through;color:red">ortant co</span>m<span style="text-decoration:line-through;color:red">pon</span>ent<span style="text-decoration:line-through;color:red">s of blueBill are: # the Obsevation API, which models a customizable repository of observations of things made by observers. # the Taxonomy API which models a life-sciences taxonomy used to represent the bird species. Please refer to the javadoc to learn about them. == Data Model == Data in blueBill is modelled using RDF, even though the Observation and Taxonomy APIs partially hide the data model under an abstraction layer. Data sets, such as taxonomies, textual or media collections used by the application are fed into it in form of RDF. Since unfortunately at the current time none of the data providers (Wikipedia and others) natively provide RDF data, the needed resources are generated by batch procedures (in the blueBill Resources project). They are typically web scrapers, or ad-hoc converters (for instance, bird checklists are mostly distributed as Excel or text files). More information about resource generation is [[Resource Generation|here</span>development<span style="text-decoration:underline;color:green">/</span>]<span style="text-decoration:line-through;color:red">]</span>. <span style="text-decoration:line-through;color:red"> A considerable effort is made to reuse existing ontologies and vocabularies keeping to the minimum those specifically developed for blueBill. This effort is performed in iterative way, with incremental changes at every release as soon as a fitting ontology is discovered and validated to replace a custom one. Since currently blueBill doesn't export data in RDF, no effort is done to preserve backward compatibility or RDF data. More info about RDF usage is [[RDF|here]].</span><span>
 
 
Close
loading
Please Confirm
Close