Updating your google-service.json from an AppCenter environment variable

Jim Bennett | Sep 25, 2018

I’ve been working on an app that needs push notifications, but also needs to be open source. This led me to a problem - the google-services.json file. This file is needed to sign up for Firebase messaging to implement push on Android, but it also contains my API keys, values I do NOT want to be public.

So - what to do?

Well I’m building and distributing my app using AppCenter and the build configuration contains a couple of useful settings that I can take advantage of - build scripts and environment variables.

I can define the contents of my google-services.json file inside an environment variable, add a dummy version to my GitHub repo, then overwrite the dummy one with the environment variable at build time. This means my secrets are safe, and the real value is protected using my AppCenter account. I can then also use the right version locally by excluding updates to this file from git as I’ve described before.

This works not only for an open source project, but if I wanted to have different settings for different builds (such as different push end points for QA or beta builds).

Check a dummy google-services.json file into source control

Add the google-services.json file to your project as normal. Blank out the file and add it to git. Revert the blanked out file and hide updates from git using:

git update-index --assume-unchanged ./google-services.json 

Run this from the root of your Android app.

Define the environment variable

From the Build configuration tab of your build in AppCenter, turn on Environment variables. Add a new variable called GOOGLE_JSON and paste in the contents of your google-services.json file.

Adding the contents of the google services json file to an environment variable

Create a build script to update the file

AppCenter can run build scripts before or after the build. These scripts have to have a specific name to be picked up by the build configuration. To create a pre-build script, create a script file in the root of your repo called appcenter-pre-build.sh. Add the following code to this script:

GOOGLE_JSON_FILE=$APPCENTER_SOURCE_DIRECTORY/<path>/google-services.json

if [ -e "$GOOGLE_JSON_FILE" ]
then
    echo "Updating Google Json"
    echo "$GOOGLE_JSON" > $GOOGLE_JSON_FILE
    sed -i -e 's/\\"/'\"'/g' $GOOGLE_JSON_FILE

    echo "File content:"
    cat $GOOGLE_JSON_FILE
fi

Update to be the path to the google-services.json file from the root of your repo. The $APPCENTER_SOURCE_DIRECTORY environment variable points to where on the build VM App Center has put your code.

This code will check for the file, and if it finds it copy the value of the environment variable into this file, followed by using a sed command to strip out escape characters as environment variables get double quotes escaped to \".

Once you add this file to your repo, it will appear under the Build Scripts in the Build Configuration.

Pre-build script turned on in the build configuration

If you Save and build the project, you will see the google-services.json file written to and dumped to the build log.

Log dump showing the file being written


You can read more about the capabilities of AppCenter on docs.com.