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_`<var translate="no">i</var>`.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.

![](https://developer.android.com/static/images/games/performance-tuner/overview-validator.svg)
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/<var translate="no">LOCAL_OS</var>/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`](https://android.googlesource.com/platform/frameworks/opt/gamesdk/+/refs/heads/master/src/tuningfork/tools/validation).

## 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](https://developer.android.com/games/sdk/performance-tuner/custom-engine/enable-api#privacy)
- Integrate the [Android Frame Pacing library](https://developer.android.com/games/sdk/frame-pacing) into your project
- Provide [fidelity parameters](https://developer.android.com/games/sdk/performance-tuner/custom-engine/define-parameters#annotations-and-fidelity-parameters) and all of your app's [quality levels](https://developer.android.com/games/sdk/performance-tuner/custom-engine/define-parameters#define-quality-levels)
- Record when your game is performing [loading events](https://developer.android.com/games/sdk/performance-tuner/custom-engine/loading-functions)
- Successfully run the [validation tool](https://developer.android.com/games/sdk/performance-tuner/custom-engine/validate-and-package#validate)
- 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](https://support.google.com/googleplay/android-developer/answer/7159011).

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](https://support.google.com/googleplay/android-developer/answer/9876283).