https://github.com/google/santa-tracker-android

Ho Ho Ho
https://github.com/google/santa-tracker-android

android android-wear firebase google santa-tracker

Last synced: about 1 month ago
JSON representation

Ho Ho Ho

• Host: GitHub
• URL: https://github.com/google/santa-tracker-android
• Owner: google
• License: other
• Archived: true
• Created: 2015-03-23T23:58:50.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2022-06-30T06:38:28.000Z (over 2 years ago)
• Last Synced: 2024-09-21T08:04:29.310Z (about 1 month ago)
• Topics: android, android-wear, firebase, google, santa-tracker
• Language: Java
• Homepage: https://santatracker.google.com/
• Size: 143 MB
• Stars: 2,075
• Watchers: 110
• Forks: 394
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-Android-Open-Source-Projects - Santa-tracker-android

README

        
Status: Archived

================

This repository has been archived and is no longer maintained.

## Google Santa Tracker for Android 🎅🤶

## About

[Google Santa Tracker app for Android][play-store] is an educational and entertaining tradition

that brings joy to millions of children (and children at heart) across the world over the December

holiday period.

The app is a companion to the [Google Santa Tracker][santa-web] website

([repository here](https://github.com/google/santa-tracker-web)), showcasing unique platform

capabilities like Android Wear watchfaces, device notifications and more.

![Village Screenshot](docs/village.png)

## Features

* A beautiful designed village

* Exciting games like Penguin Swim and Rocket Sleigh

* Use of Dynamic Feature Modules (each game is a separate module, fetched dynamically on first run)

* Interactive Android Wear watchfaces (with sound!)

* Videos, animations and more.

## Building the app

First up, Santa Tracker is powered by [Firebase][firebase], so you'll need to enable it

on your Google account over at the [Firebase console][fire-console]. Once you're in the

console, follow these steps:

 * Create a new project

 * Add Firebase to your Android app

 * Package name: `com.google.android.apps.santatracker.debug`

 * Debug signing certificate can be blank, or follow the instructions in the tooltip to find yours.

 * Save the `google-services.json` file to the `santa-tracker/` directory

Now you should be able to plug your phone in (or fire up an emulator) and run:

    ./gradlew santa-tracker:installDebug

Alternatively, import the source code into Android Studio (File, Import Project).

Note: You'll need Android SDK version 28. If you're unsure about this, use

Android Studio and tick the appropriate boxes in the SDK Manager.

## License

All image and audio files (including *.png, *.jpg, *.svg, *.mp3, *.wav, *.ogg, *.m4a, *.webp) are

licensed under the CC-BY license. All other files are licensed under the Apache 2 license.

See the LICENSE file for details.

    Copyright 2019 Google LLC

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

        https://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.

[play-store]: https://play.google.com/store/apps/details?id=com.google.android.apps.santatracker

[santa-web]: http://g.co/santatracker

[firebase]: https://firebase.google.com/

[fire-console]: https://firebase.google.com/console/