niccokunzmann / mundraub-android Goto Github PK

View Code? Open in Web Editor NEW

33.0 4.0 23.0 20.44 MB

📱Android App for Mundraub, Na-Ovoce and other fruit maps

Home Page: https://f-droid.org/en/packages/eu.quelltext.mundraub/

License: GNU General Public License v3.0

Java 86.32% Shell 2.02% HTML 3.35% JavaScript 5.48% CSS 2.31% Python 0.39% Ruby 0.12%

app android map plants

mundraub-android's Introduction

Mundraub-Android

Barely maintained: I do not actively develop this app any more. If you like to contribute feel free, I can merge your pull requests and also hand development over.

This is the Android app for Mundraub.org which allows you to store the found plants on the phone and upload them when an Internet connection is available.

The API level is 9 so the application can run on old mobile phones.

Download

The latest version can be downloaded from GitHub

Contribute

Contributions are welcome.

To add another supported language, translate the app on Transifex. Suggestions on new languanges to support can be submitted through an issue.
The app is developed on Android Studio . We suggest starting development with small issues.
Permission is not necessary to begin working on the app - The app is free software so anyone is able to modify it. Helpful tips for the developing process:
- leaving a comment allows others to support you and ensures no duplicate work is done.
- Start a pull request as soon as possible so the community can support you and Travis can check your code. Earlier feedback means faster development.
Feedback is welcome, please open an issue.
- Crash:
  - Report a debug log file if you gave EXTERNAL_STORAGE permissions or use logcat to retrieve the log. If you gave permissions, you should be able to find it under eu.quelltext.mundraub.log.txt or eu.quelltext.mundraub.error.txt. The app (if starting) should point you to the file.
  - Use MatLog Libre to retrieve the app log before and after a crash.

Pease read the following pages: Setup Guide, Contribution Guidelines and the documentation.

Software Material List

App components:

OpenLayers for refining te position
okhttp for making requests
commons-lang3 for useful functions everywhere
nanohttpd for providing an API to the map

APIs:

For publishing the found plants and markers on the map:
- Mundraub.org (German)
- Na-Ovoce.cz (Czech)
- FruitMap.org (Slovakian, English and Czech) (download only)
- www.quelltext.eu in case the insecure connections for old Androids are enabled.
openstreetmap for rendering OpenStreetMap
World Imagery for rendering a satellite map
staticmap for fetching the map preview
OpenStreetMap's Nominatim to search for places on the map

Services:

Travis to build the app and test the code
GitHub for publising and contributing to the code
Transifex for managing translations
- Microsoft Translate with a free account for suggesting translations.
F-Droid for publishing the app
Google Play for publishing the app

Languages:

Java for the app, Android 2.3 GINGERBREAD
HTML/CSS/JavaScript for the map

Related Work

mundraub-android's People

Contributors

Stargazers

Watchers

mundraub-android's Issues

remember the selected layer of the map

The map has two layers. When I open the map again, I would like to view the last selected layer.

Solution idea:
Use cookies such as with https://github.com/CoderDojoPotsdam/regex-tutorial/blob/master/js/cookies.js

set them when the layer is selected
load them when the website starts

Allow localiztion of the app

The German language is started. Please allow switching from German to English.

Do not save plants with only default entries

If a plant was not edited, just has the fields from the start

delete this plant when the new plant activity is closed
stop GPS position updates on the plant as they are no use

Set edit icon in details view

When I want to edit the plant, I would like to see an icon in the floating action button which is a pencil. We may use the pencil from here: http://niccokunzmann.github.io/

Ask if plant should be deleted

Currently, it is easy to delete plants online.
Please add a dialog asking the user if they really like to remove the plant and all comments and history of it.

GPS update resets writing the message

When the GPS position is set of a plant, all entries of the plant are re-written. This resets the curser of the description.

Two possible solutions:

update only GPS related views
set the curser to the position again.

Accept the rules before uploading

The Mundraub rules need to be accepted first before we can upload anything. This needs to be made sure.

View map from details

When I click on a plant, I would like to click on the map of the plant in order to see where the plant is located. Please open the Activity to show the map there.

Hint:

When viewing details, I do not want the plant to change.
Display a button at the bottom of the web view activity to to just go back and hide the edit buttons.
You can pass the EDIT_PLANT = false as Intent argument.

Show big image when clicked

When I open the plant details and click on the image of the plant,
I would like to see this image in big.

We're using [Polar.sh](https://polar.sh/niccokunzmann) so you can upvote and help fund this issue. We receive the funding once the issue is completed & confirmed by you. Thank you in advance for helping prioritize & fund our work.

Show plants on map

We can query the Mundraub.org API and get plants as JSON. example. Please show them on the map.

related #31

Add loading animation

The app takes quite a while to load.
We can bridge this with a loading animation.

[PERMISSION] ask for GPS

When we create a new plant, we would like to get the current GPS location.
If this is disabled, please ask for the permission to be given.

Talk to Mundraub

#20 #19 both can be done when reasonable effort went into communication with mundraub.org.

Create settings

Create a Settings class
- include some global variables
  - dummy api
  - insecure https
  - PersistentPlantCollection STORAGE_DIRECTORY_NAME
  - build commit
  - build tag (1.X)
  - version: set to template like 1.$TRAVIS_BUILDXY

animate upload operation

When operations like delete, upload, login take place, please show a small button-high loader to the user.
When the view exists, no dialog needs to be shown.

[OpenLayers] Map: add layer for satellite

Sometimes plants are better to place not on the map of streets but on a satellite image.

add a layer and a layer chooser for the satellite image. E.g. see https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/16/22976/34861/
add a copyright notice for this

file: assets-> ... -> fullScreen.js

Use official Mundraub Colors

Mundraub may still be a trade mark of the https://mundraub.org and the people behind it. We can not use the name for us but we may use the colors. Please change the default colors of the app and see if e.g. buttons could use another color.

picture quality is low

The quality of the pictures used in the app is much lower than the quality which could be achieved by the camera.

Stop GPS updates when app closes

When a new plant is created, it gets a GPS location. When the app closes, still gps is requested.
Solution: cancel the GPS update once the app closes.

onDestroy in the new plant activity does not work.
related: https://stackoverflow.com/questions/13785720/android-onclose-event

Find out if plant is existent online

A plant may be deleted online. If it is, we should be able to detect it and upload it again.
Currently, published plants can not be uploaded again.

Scroll back to the position in plant list

When the Plant listing activity is entered again, it should be at the same position as it was left.

Hint:
We can use onSave (see the new plant activity) and the savedInstanceState

Use closest plant if no position is given

When a plant has no position, it should not start at (0,0).
Instead

choose the plant created closest in time and use its position

Uncertain Position

The position should be uncertain:

GPS uncertainty
time since the recording of the position

This must be displayed and a base for asking, see #27

Create Credits Page

The OpenLayers License requires readable reproduction of the license in binary format. GPL possibly, too.

Solution: Create a Credits/About Page

Show the Apache License
Show the GPL license
Link to the source code (open repository)
invite people to contribute
report an issue (open link to github issues)
Open the credits page from the menu of the app

secure connection to mundraub

In Android 2.3.X we can not verify the connection to mundraub.org.
This encrypts the connection but is vulnerable to man in the middle attacks.

I tried to pin the certificate but was out of luck:

    private HttpsURLConnection openSecureConnection(URL url) throws CertificateException, NoSuchProviderException, KeyStoreException, IOException, NoSuchAlgorithmException, UnrecoverableKeyException, KeyManagementException {
        // from https://stackoverflow.com/a/34533863/1320237
        ByteArrayInputStream derInputStream = new ByteArrayInputStream(certificateString.getBytes());
        CertificateFactory certificateFactory = CertificateFactory.getInstance("X.509","BC");
        X509Certificate cert = (X509Certificate) certificateFactory.generateCertificate(derInputStream);
        String alias = "mundraub.org";//*/ cert.getSubjectX500Principal().getName();
        Log.d("alias", alias);

        KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());
        trustStore.load(null);
        trustStore.setCertificateEntry(alias, cert);
        KeyManagerFactory kmf = KeyManagerFactory.getInstance("X509");
        kmf.init(trustStore, null);
        KeyManager[] keyManagers = kmf.getKeyManagers();

        TrustManagerFactory tmf = TrustManagerFactory.getInstance("X509");
        tmf.init(trustStore);
        TrustManager[] trustManagers = tmf.getTrustManagers();

        SSLContext sslContext = SSLContext.getInstance("TLS");
        sslContext.init(keyManagers, trustManagers, new java.security.SecureRandom());
        HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
        conn.setSSLSocketFactory(sslContext.getSocketFactory());

        return conn;
    }

    // use the first certificate from
    //     openssl s_client -showcerts -servername mundraub.org -connect mundraub.org:443 </dev/null
    // source: https://stackoverflow.com/a/7886248/1320237

    private final String certificateString = "-----BEGIN CERTIFICATE-----\n" +
            "MIIFkjCCBHqgAwIBAgIQDhJsU3G9TP7jmWtUNknpEzANBgkqhkiG9w0BAQsFADBu\n" +
            "MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\n" +
            "d3cuZGlnaWNlcnQuY29tMS0wKwYDVQQDEyRFbmNyeXB0aW9uIEV2ZXJ5d2hlcmUg\n" +
            "RFYgVExTIENBIC0gRzIwHhcNMTgwODAzMDAwMDAwWhcNMTkwMTEzMTIwMDAwWjAX\n" +
            "MRUwEwYDVQQDEwxtdW5kcmF1Yi5vcmcwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw\n" +
            "ggEKAoIBAQCeRCSeqXweyyT2+cvdqbn7Y3ct3uG7K+X16V3HyASIT2mFgKC1s6kS\n" +
            "Btl0k+HnEw4xWL88J+NheJU8vY53dPmpKXaDFUSz4zpx3HG0Oca1UZB0eypuUtsc\n" +
            "1jng2YJsIu+EBU7x+gXpmPyBlBqmavCJD0Yj1DNys7Qk/cztEyRI3K6FH0KyTJe7\n" +
            "RZIyPYiwnoFbJmt5+ghJnbZjkFpLR2Y/+51SwkTWRFdRVBo36QblM5u1vrGOU6ck\n" +
            "Z9sy1SjuHh/KRGqjIrZOyCFXuw3EqOnzJ1jcZ3XES0vJbYCdaElyMOwcJCOKuwM4\n" +
            "J6oAsdlYhV2E2TbGEHqiKelwS80JgxSHAgMBAAGjggKBMIICfTAfBgNVHSMEGDAW\n" +
            "gBR435GQX+7erPbFdevVTFVT7yRKtjAdBgNVHQ4EFgQUGGioYrSiOUAkYqH948Y9\n" +
            "BIN/YL8wKQYDVR0RBCIwIIIMbXVuZHJhdWIub3JnghB3d3cubXVuZHJhdWIub3Jn\n" +
            "MA4GA1UdDwEB/wQEAwIFoDAdBgNVHSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIw\n" +
            "TAYDVR0gBEUwQzA3BglghkgBhv1sAQIwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93\n" +
            "d3cuZGlnaWNlcnQuY29tL0NQUzAIBgZngQwBAgEwgYAGCCsGAQUFBwEBBHQwcjAk\n" +
            "BggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEoGCCsGAQUFBzAC\n" +
            "hj5odHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRW5jcnlwdGlvbkV2ZXJ5d2hl\n" +
            "cmVEVlRMU0NBLUcyLmNydDAJBgNVHRMEAjAAMIIBAwYKKwYBBAHWeQIEAgSB9ASB\n" +
            "8QDvAHYApLkJkLQYWBSHuxOizGdwCjw1mAT5G9+443fNDsgN3BAAAAFlADdgMQAA\n" +
            "BAMARzBFAiApdIeKdwK2H6+fGJiohXUtBqMXEWz/uGPqjIZatzWgUAIhAPdV7BUp\n" +
            "qHEh99W68ulsODWwCCBAYhf4G5NoWXUgFZFAAHUAh3W/51l8+IxDmV+9827/Vo1H\n" +
            "Vjb/SrVgwbTq/16ggw8AAAFlADdhGAAABAMARjBEAiAglHH5nPm3VVxuGYYfIL5U\n" +
            "EufUMNh4e1GtgfJIrNWYTAIgbK098qxs1Rr4/jYcUssA3Ae7zUSLoZQN2x+8iIHD\n" +
            "UnUwDQYJKoZIhvcNAQELBQADggEBAG4Nt15kYFYykOyVC7jGJUo90d1RyHi5tI6g\n" +
            "YblouTnWWcSMI6f1Ep/gQ/wA2BDzz9koYTC8DVDvYZN8KoRx80dYfzA+Of/IEk8H\n" +
            "2JNkULyPF3xS2AewTqKhonYodtD4qGenslHEYJ8/le+7vX16cSltwS59pYV5S7Nn\n" +
            "y+dnYhZCasudQSTV3n/56CNqdxa/Shtgc0FyUI20va7nOLuzglhhH9g6SHSb6RU6\n" +
            "Gq0HjiPOSTXN6/lEq7ES2Xj9mOD+JMsBG9iTIfCxCFPx6XfrriqKLhy9RDZnhe2P\n" +
            "hqT+YNN7gUsljPKFJ0ZjgcSaXAsWqqZ3Pn86Yd2eIAxoFNpD140=\n" +
            "-----END CERTIFICATE-----\n";

Publish the App on f-droid

The app store f-droid can be used to distribute the app.
Please add this app to the f-droid store.

Gradle 4.4 build is unreliable on Travis

We use sdkman to build the project on travis.
However, sometimes downloading the archives does not work.
This breaks the build several times.

Solution ideas:

check if travis has a gradle version preinstalled (4.1) and we can use that for the build
check if we can use Gradle 4.4 on Travis preinstalled
check how to install gradle 4.4 reliably
- maybe using the cache directory for caching the archive for sdkman

[API] Implement deleting plants

Please implement that the published plants can be deleted by the app.
When the plant is deleted, it can not be deleted any more.
Check if the plant is existent and use that as return code.

[PERMISSION] save files

If WRITE_EXTERNAL_STORAGE is not given, we can not save plants. Please ask when the app starts if we can use that.

activity state lost on screen rotation

When I create a new plant
And I rotate the screen,
I would like to see the plant I filled stuff in
But I see a new empty plant

Map cannnot be moved

Somehow, the map can not be moved. I can not drap it.

Animate login and log in automatically

In order to upload a plant, we must log in first.
If user-name and password are saved, this can be tried automatically once.
Also use the animation from #47 if it is implemented already.

Show which plants are uploaded to mundraub

When I skip through the list of plants, I would like to see which plants are uploaded.
Please add an icon to the plant.

Use Mundraub marker on map

Different plant types have different markers.

add the Mundraub markers as picture to the map
add a parameter for the map
use the marker as displayed on the map
add the Mundraub markers as picture resource (see how to make a file to a resource)
display the marker picture when the plant type is chosen

Try out the app & document how to use it

Download the app from https://github.com/niccokunzmann/mundraub-android
Install it on the device
Add a new plant
log in
publish the plant
Write what you did and how with pictures to the /docs folder.

[PERMISSION] ask to connect to the Internet

Before we can use any web services, it would be nice to switch on the Internet connection.

Login & upload
caching tiles
showing the map

Publish and sign the app for google play store

Here, we may get help from FOSSASIA on how to do this.
We need to sign the app.
Upload it to a developer account.
Each time a change is made, the app should be uploaded automatically.

Add + button for fast count change

Sometimes I find new plants nearby. Then, I would like to use a + button to increase the count.

Create app walk-through video

We can create a video which shows how to use the app once we are in the forest and come back.

Edit map from description

There is a map view in the description. When this view is clicked, it should open the map and allow repositioning.

[API] Allow uploading changed plants to mundraub

Once a plant is published, some parts can still be edited.

Roadmap:

delete #6 and re-post plant if #6 is done
use the edit plant form and post the data

Add a callback for deletion which can be added to the plant.

DeletionCallback plant.notifyOnDelete(new Plant.DeletionCallback() {
    onDelete() {
    }
})
plant.removeNotification(...) // called when GPS is set

add GPS to edited plant later

Let GPS run even if the new plant activity is closed. This way, several plants can get a first position even if we walk on or add other plants.

GPS should check if the plant is deleted and if it is not deleted, should set the position.
GPS runs per default when the plant is created.

Check if plants were deleted online

Add a check once a plant is opened, to see if it is still available on-line.

Ask for repositioning on map if position is from GPS

Problem: Sometimes GPS is not close enough to the position.
Solution:

save the GPS precision in the position
ask if the precision is too low/when the position is from GPS when the user wants to publish the plant
The dialog should have the options

Publish
open map