Validate, package, and publish the APK

Use the instructions on this page to upload a validated APK to Google Play.

Validate the proto files

Place the following files in your APK assets folder under assets/tuningfork:

• dev_tuningfork.proto
• tuningfork_settings.txt
• Several dev_tuningfork_fidelityparams_i.txt files, in increasing fidelity order

The validation tool generates binary (.bin) serialized protocol buffers of the settings and default fidelity parameters files in the assets/tuningfork directory. The tool itself is located in the src/tuningfork/tools/validation directory.

The validation tool generates binary files

Run the following commands to validate the sample project. Substitute one of the following for your operating system (LOCAL_OS):

• mac
• win
• linux-x86

cd gamesdk/src/tuningfork/tools/validation
java -jar build/libs/TuningforkApkValidationTool.jar \
  --tuningforkPath ../../../../samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork \
  --protoCompiler ../../../../third_party/protobuf-3.0.0/install/LOCAL_OS/bin/protoc

Output ending in the following appears:

...

May 19, 2020 3:42:11 PM com.google.tuningfork.validation.TuningforkApkValidationTool main
INFO: Tuning Fork settings are valid

For more information on running the validation tool, see the validation tool README.

Review the integration checklist

Before uploading your APK to the Google Play Console, do the following:

• Review and, if necessary, update your app's Privacy Policy
• Integrate the Android Frame Pacing library into your project
• Provide fidelity parameters and all of your app's quality levels
• Record when your game is performing loading events
• Successfully run the validation tool
• Run your game in debug mode and validate the output using logcat or the Tuning Fork Monitor app
• Confirm that you and other relevant game engineers have access to Android Vitals in the Google Play Console

Upload and publish

To receive performance insights, upload your new APK to the Google Play Console and create a release. You can release on Google Play to test tracks or to your entire user base. For more information on creating a release, see the Console Help Center documentation.

Once you have published your APK, you can receive new performance insights from your users in the Google Play Console under Android Vitals > Performance > Insights. For more information, see the Performance insights documentation.