v0.3.0 Release Checklist

[vestrel00]

Target release date

I don't have an exact target date. So, for now, let's just say...

June

Need something sooner than the target date?? Leave a comment on this discussion and let me know what you need! We’ll figure something out 😁

Changes to be included in the release

I'm not using milestones to group issues into releases because I'm using milestones for a different purpose for versions prior to v1.0.0

New features

1. API for moving any RawContacts to different Accounts (or null account) #168

Bug fixes

1. When updating groups, the title is always redacted (replaced with asterisks "*")  #281
2. Null pointer exception in Fields.all (on first use in multi-threaded API usage) #286

Improvements

1. Add display name, account, and options properties to RawContactEntity #268
2. Support for RawContact IDs in AccountsQuery #276

Improvements with breaking changes

1. Replace AccountsLocalRawContactsUpdate API with a better one #282
2. Remove Account restrictions for Group, GroupMembership, Relation, and Event #167
3. Support setting/removing Contact/RawContact Photos as part of Insert and Update API calls #119
4. Allow different Accounts for each RawContact in insert APIs #270
5. Move set Contact/RawContact Options functions to be part of Insert and Update APIs #120
6. Remove BlankRawContact entity #269
7. Generalize AccountsRawContactsQuery to RawContactsQuery #271
8. Move Contact link/unlink extensions to a dedicated API #138

Dependency upgrades

These should not affect users of this library at all. Just an FYI 😉

1. 2023 June Dependency Upgrades (most notably AS Flamingo + AGP 8 + Gradle 8 + JDK 17 + SDK 33 + JitCI -> Circle CI) #274

Milestones

I'm also aiming to complete all milestone two issues for completing the sample app; https://github.com/vestrel00/contacts-android/milestone/4

This will mark the completion of v0.2.x 🔥🎉

Release management steps

Stuff that needs to be done before, during, and after the release.

Before publishing release

• Double check that there are no regressions for all relevant API functions!
• Double check that relevant documentation in code, README, DEV_NOTES, and all howto pages are correct.
• Ensure that JitPack SNAPSHOT of the main branch is green and installable.

Publishing the release

• Update the README with installation instructions for 0.3.0.
• Update gh-pages branch.
• Create the 0.3.0 tag.
• Publish the 0.3.0 release.

After publishing release

• Sanity check install 0.3.0 from JitPack in a new project. (The first JitPack release build typically fails to install. Don't panic. Just delete the build and rebuild it.)
• Leave a comment in this discussion with a link to the release.
• Leave a comment in each of the above issues with a link to the release.
• Unpin this discussion and pin the next release's discussion page.
• Close the previous release's discussion / checklist

[vestrel00]

The release is out now! https://github.com/vestrel00/contacts-android/releases/tag/0.3.0