catrobat / paintroid-flutter

Paintroid

Paintroid, also known as Pocket Paint, is associated to Catroid. It is a graphical paint editor application for the Android platform that, among others, allows setting parts of pictures to transparent.

Since Pocket Paint is now available in Google Play store you can also download Paintroid (Pocket Paint) from here. Alternatively, you can find it on F-Droid here.

For more information oriented towards developers please visit our developers page.

Note This repository is the Flutter version of Paintroid

Getting Started

1. Install Flutter:
   • Currently used version specified in .github/workflows/main.yml
   • Recommended: Use fvm for managing Flutter versions
2. Get dependencies: make get
3. Run app: make run

Alternatively make allcan be used to:

flutter clean → flutter pub get → build_runner build → sort → flutter run

Building generated files

• run make build

Tests

• Run tests for all packages:
  • all: make test
  • unit: make unit
  • widget: make widget

For integration tests:

1. Make sure you have an iOS/Android device online by running flutter devices
2. Run make integration to run all integration tests Run make integration target=name_test to run a specific integration test file (make sure to add the test suffix to the file name)

Issues

Please report all bugs on our Jira Bugtracker

Contributing

If you want to contribute we suggest that you start with forking our repository and browse the code. Then you can look at our Issue-Tracker and start with fixing one ticket. Please make sure to pick a ticket with the status "Ready for development" and comment on the ticket that you are working on it. We strictly use Test-Driven Development and Clean Code, so first read everything you can about these development methods. Code developed in a different style will not be accepted. When you are done, comment again on the ticket and create a pull request on github. After you've created a pull request we will review your code and do a full testrun on your branch.

Let's start to set up the working environment using the instructions in our Wiki!

Resources and links

• Google Play Store Download
• F-Droid Download
• Frequently Asked Questions
• Credits
• Statistics on OpenHub
• Twitter
• Our Google group

License

License of our project (mainly AGPL v3).