taler-android

Android apps for GNU Taler (wallet, PoS, cashier)
Log | Files | Refs | README | LICENSE

SCREENSHOTS.md (2013B)

      1 # Merchant Terminal screenshots
      2 
      3 This module now has a debug-only screenshot mode for deterministic captures of real app screens.
      4 
      5 ## What it does
      6 
      7 - Launches the app directly into a named scenario using an intent extra.
      8 - Seeds fixed merchant config, products, totals, and product thumbnails in-process.
      9 - Captures the resulting screen with `adb exec-out screencap`.
     10 
     11 Bundled fixture product images are generated locally by `merchant-terminal/scripts/generate-screenshot-product-images.sh`, so the default workflow does not depend on third-party image licenses.
     12 
     13 ## Supported scenarios
     14 
     15 - `amount-entry`
     16 - `order`
     17 - `payment`
     18 - `payment-success`
     19 
     20 ## Generate fixture product images
     21 
     22 ```bash
     23 merchant-terminal/scripts/generate-screenshot-product-images.sh
     24 ```
     25 
     26 The images are written to `merchant-terminal/src/debug/assets/screenshot-products/`.
     27 
     28 ## Capture screenshots
     29 
     30 Connect an emulator or device, then run:
     31 
     32 ```bash
     33 merchant-terminal/scripts/capture-screenshots.sh
     34 ```
     35 
     36 Custom output directory:
     37 
     38 ```bash
     39 merchant-terminal/scripts/capture-screenshots.sh /tmp/merchant-terminal-shots
     40 ```
     41 
     42 Specific scenarios only:
     43 
     44 ```bash
     45 merchant-terminal/scripts/capture-screenshots.sh /tmp/merchant-terminal-shots order payment
     46 ```
     47 
     48 ## Intent hook
     49 
     50 The debug hook is activated with:
     51 
     52 ```text
     53 --es taler_pos_screenshot_scenario <scenario>
     54 ```
     55 
     56 Example:
     57 
     58 ```bash
     59 adb shell am start -W \
     60   -n net.taler.merchantpos/.MainActivity \
     61   --es taler_pos_screenshot_scenario order
     62 ```
     63 
     64 ## If you want real photos later
     65 
     66 For external product photos, use sources with clear reuse terms and record the exact asset URLs and license notes alongside the files you import.
     67 
     68 Reasonable options:
     69 
     70 - Pexels license: https://www.pexels.com/license/
     71 - Unsplash license: https://unsplash.com/license
     72 - Wikimedia Commons reuse guide: https://commons.wikimedia.org/wiki/Commons:Simple_media_reuse_guide
     73 
     74 For maximum simplicity in a repo, prefer public-domain or CC0 assets, or keep using locally generated fixture images for screenshot automation.