Skip to content

v8.7.0

Choose a tag to compare

View all tags
@penmetsaa penmetsaa released this 21 Jul 09:49
· 986 commits to master since this release
v8.7.0
1ad92eb

Hi all,

Please find the new JARs on the maven site here.

The new release contains metadata changes and some code changes. Upgrading to the latest release is always encouraged since phone number information changes often!

New functionality in this release:

  • New getSupportedCallingCodes() API in C++, Java, and JS to return all the calling codes that the library considers valid, both for geographical and non-geographical entities.
  • New isSmsServiceForRegion(PhoneNumber, RegionCode) API in C++ and Java short number info libraries. An SMS service is where the primary or only intended usage is to receive and/or send text messages (SMSs). This includes MMS as MMS numbers downgrade to SMS if the other party isn't MMS-capable.
  • Java public APIs that used to take in strings representing phone numbers or parts of phone numbers now take in CharSequence instead. This affects ShortNumberInfo and PhoneNumberUtil.

Heads-up:

  • In phonenumberutil.h, we removed most of the using std::* statements, leaving only using std::string, and changing phonenumberutil.cc and phonenumberutil_test.cc to prefix std:: for other usage in the code. If you were relying on these using statements, your build will likely stop compiling. This is not considered a breaking library change since depending on these is not considered good C++ practice, hence our not changing the major version number with this change; however if you were relying on us exporting these symbols, you will have to make similar changes to prefix the relevant std collections appropriately.

Porters only:

  • The is_sms_service metadata is serialized for the first time in C++ and JS metadata.
  • Documentation update for private variables VALID_PUNCTUATION and SINGLE_INTERNATIONAL_PREFIX, also renaming the latter from UNIQUE_INTERNATIONAL_PREFIX.

Full details in the release notes.

Note if you take advantage of this new functionality by changing your code,
it will not necessarily be trivially easy to roll back to a previous version.

Thanks to all those who contributed by providing issue reports and pull requests!

Want to be notified of future releases? Join the discussion group!

Assets 2
Loading