2024.4 での変更点
Release date: October 24th, 2024
ADT component versions
The AccelByte Development Toolkit (ADT) 2024.4 release contains the following component versions:
- ADT Web v1.29.0
- ADT Hub v1.4.0
- ADT Mobile Web v1.1.0
- ADT Status Page v1.1.0
- ADT SDK v2.28.7
- ADT CLI v2.24.0
Release highlights
Smart Build improvements
ADT has enhanced the Smart Build feature to increase performance and reliability in response to customer feedback.
Reliability improvements
ADT has implemented exponential back-off retries for server errors, randomized prefix request order to reduce load, increased caching with Amazon CloudFront, expanded geographical testing, and collaborated with customers for real-world testing. These improvements aim to address previously reported issues of inconsistent build integrity, build failures, and unpredictable download speed for builds, which were caused by Amazon Web Services (AWS) S3 server errors, an undocumented prefix limit, and variability in geography and hardware.
Smart Build preparation phase improvements
The Smart Build preparation phase has been enhanced to significantly reduce processing time by implementing two key changes:
- Cached and served the build manifest via CloudFront to reduce server load.
- Optimized the local cache database format for faster hash checks.
These changes cut processing time by 10 to 20 times, reducing the preparation phase to just a few seconds. Previously, delays of one to three minutes were common due to large build manifests and slow hash comparisons.
Smart Build download phase improvement
The Smart Build download process involves retrieving changed files and updating the local cache. Two main issues were identified: writing to the local cache was slower than downloading, especially with many small files, and frequent CloudFront cache misses hindered download speeds. To address these challenges, ADT has implemented three key changes:
- Refactored the local cache database for greater efficiency.
- Introduced improved multi-threading capabilities.
- Collaborated with AWS to reduce cache misses.
These changes led to more efficient bandwidth usage and significantly improved download performance.
Here's the comparison between the old version versus the new version of Smart Build:
- Preparing and Staging time improvement graph
- Download to playtime improvement graph
ADT Hub v1.4.0
ADT Hub v1.4.0 reintroduces all the bug fixes from v1.3.0 that were rolled-back in v1.3.1. These fixes were initially withdrawn in v1.3.1 due to problems that affected the download speed of Smart Builds. With v1.4.0, these fixes are restored, resolving previous issues while ensuring improved performance and stability for Smart Build downloads.
The Local Cache Management automation feature has also been added to ADT Hub v1.4.0. to control the cache size of downloaded builds in your local machine, optimizing your system's storage usage and performance.
To enable this automation, you must configure your preferred limit for the cache size of your downloaded builds and set the schedule for when to run the automation. At the scheduled time, ADT Hub triggers the automation to perform the following actions:
- Cache size check: ADT Hub checks if your local cache size exceeds the specified limit.
- Cache purge: if the cache size exceeds the specified limit, ADT Hub will automatically delete the cache from the oldest downloaded builds. If, for example, you've set a cache limit of 20 GB and your current cache size is 35 GB, ADT Hub will delete the oldest cache from builds totaling 15 GB to bring the cache size down to the 20 GB limit.
To learn more about using this feature, see Manage local cache size of downloaded builds.
One-time migration process for Smart Builds
To support the Local Cache Management feature, a one-time migration process will automatically occur during your first build download after you've updated to ADT Hub v1.4.0. The migration process will ensure data is streamlined with your new downloads and prevent ADT Hub from downloading whole builds.
Get Log feature enhancement
The Get Log feature has been enhanced to collect more comprehensive logs related to issues with Smart Build downloads, ADT Hub updates, auto-updating of builds, etc. As a result of this improvement, the log generation process may now take a couple of minutes longer to complete depending on the volume of data.
Keep the Application Settings window open until the log files are created, as closing it will terminate the log generation process.
Bug fixes
ADT Web
- Fixed the issue where SSO users still have Guest permissions.
- Fixed the issue that caused an error message to appear when a single quote (') character is used to create a new password during registration or password reset process.
- The Hardware Information and Crash Video tabs are now disabled when they don't contain any data.
ADT Hub
- Implemented character limit for version and build names when uploading builds using the drag-and-drop option.
- Implemented logs to capture all actions performed within channels and store them in the database.
- Updated the date format to display as "Month/Day/Year" and the time format to include the timezone offset for the banner.
- Implemented notifications for the cache clearing process to inform users of the process duration and end time.
- Fixed the issue that forced users to repeatedly click the build redirector URL to access the correct build.
- Fixed the issue that prevented users with QA role from sharing builds from the Versions tab.
- Fixed the issue that prevented the page indicator from appearing when the banner is displayed.
- Fixed the failed downloads and download speed issues in Smart Builds.
- Fixed the failed downloads issue due to receive 504 response from the servers.
- Fixed the issue where users downloading the whole files for incremental builds after updating to the new ADT Hub.
- Fixed the issue where Smart Builds download stopped because of file integrity check failure.
- Restored the following bug fixes from v1.3.0:
- Implemented automatic retry for a failed update track download.
- Fixed the issue where the track card displayed an infinite three-dot progression without any information.
- Fixed the issue where relaunching during the preparation phase caused ongoing downloads to get stuck.
- Fixed the issue where users previously needed to reinstall the ADT Hub to receive updates.
- Fixed the issue where the build channels for inactive game spaces does not receive automatic updates.
- Fixed the issue where the Preparing phase while downloading builds through the Auto-update feature is not canceled when ADT Hub is relaunched.
Known issues
Smart Build download completion delay
ADT has identified an issue where, as a Smart Build download nears completion, there may be a delay of up to one minute. This occurs when builds contain a large file (over 1 GB), causing the background file integrity check to take longer than expected. However, there are no issues with the resulting download, and everything functions as expected.
Fixed previously reported issues
ADT has fixed some of the previously reported issues from the "Known Issues" list. For the updated list of known issues in ADT components, along with their status and workarounds, refer to the ADT known issues list.