Skip to content

Releases: smsaero/smsaero_java

3.3.0

Choose a tag to compare

@smsaero smsaero released this 01 Apr 18:55

Added

  • Added Mobile ID authorization support: SendMobileId, MobileIdStatus, VerifyMobileId.

v3.2.0

Choose a tag to compare

@smsaero smsaero released this 18 Feb 07:57

Release Notes: v3.2.0

What's New

Test Mode

  • EnableTestMode() — Switch to test endpoints (sms/testsend, sms/teststatus, sms/testlist). No real SMS are sent and no charges apply.
  • DisableTestMode() — Switch back to production mode.
  • IsTestModeActive() — Check whether test mode is enabled.

Useful for development and debugging without affecting your account balance.

Command-Line Interface (CLI)

  • New fat JAR artifact: smsaero-3.2.0-cli.jar with ru.smsaero.CommandLine as main class.
  • Send SMS from the command line:
    java -jar smsaero-3.2.0-cli.jar --email YOUR_EMAIL --api_key YOUR_API_KEY --phone 70000000000 --message "Hello"
  • Supports environment variables: SMSAERO_EMAIL, SMSAERO_API_KEY, SMSAERO_PHONE, SMSAERO_MESSAGE, SMSAERO_SIGN.
  • Options: --sign (sender signature), --debug (test mode).

Docker Support

  • Official Docker image: smsaero/smsaero_java:latest
  • Run CLI in a container:
    docker run --rm smsaero/smsaero_java:latest --email YOUR_EMAIL --api_key YOUR_API_KEY --phone 70000000000 --message "Hello"

CI/CD

  • GitLab CI pipeline with stages: test, compat, build.
  • Compatibility matrix: Java 11, 17, 21, 25.

Core Library Improvements

  • Thread safety — Instance fields are now thread-local where needed; client is safe for concurrent use.
  • Retry logic — Automatic retry on transient network errors (timeouts, connection refused, etc.).
  • Validation — Constructor validates email and apiKey (non-null, non-blank); throws IllegalArgumentException on invalid input.
  • Timeouts — Configurable connect (10s) and read (30s) timeouts.
  • Javadoc — Added documentation for public API.

Documentation

  • README updated with Maven Central badge, API docs link, and usage examples.
  • Russian documentation: README.RUS.md.
  • Note: Java 8 users should stay on v3.1.0.

Testing

  • New unit tests in SmsAeroTest.java (JUnit 5).

Breaking Changes

  • Minimum Java version: 11 — Java 8 is no longer supported. Use v3.1.0 for Java 8 projects.

Migration from v3.1.0

  1. Update Maven/Gradle dependency to 3.2.0.
  2. Ensure your project uses Java 11+.
  3. No API changes for existing SmsAero usage; new methods (EnableTestMode, etc.) are additive.

v3.1.0

Choose a tag to compare

@smsaero smsaero released this 17 Feb 05:16

Last release for Java 8, 9, and 10.

v3.0.0

Choose a tag to compare

@smsaero smsaero released this 06 Jul 20:55
Release 3.0.0

2.2.0

Choose a tag to compare

@smsaero smsaero released this 29 Sep 09:11
Initial commit