/pip-navigation

A sample about navigation patterns with PIP. This is an extension of Google's android-PictureInPicture sample.

Primary LanguageJava

Android Picture-in-Picture navigation sample

This sample is an extention of the official sample on Picture-in-Picture(PIP) from Google.

Introduction

This sample focuses on the navigation behavior when a PIP-able activity is deeper in the back-stack. The behavoir is different for fragment-based and activity-based navigation. There is a menu option to switch between the two navigation architectures when running the app.

You can read the documentation to learn more about PIP. There are two small blog posts on medium that also dive into PIP, Making magic moments with PIP and Navigation patterns with PIP

You can comment out the finish() method in WatchActvitiy to see how an app will act without accounting for losing the back-stack when restoring from PIP mode.

Pre-requisites

  • Android SDK 26
  • Android Build Tools v26.0.1
  • Android Support Repository

Getting Started

This sample uses the Gradle build system. To build this project, use the "gradlew build" command or use "Import Project" in Android Studio.

Support

If you've found an error in this sample, please file an issue: https://github.com/benbaxter/pip-navigation

Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.

License

Copyright 2017 The Android Open Source Project, Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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

http://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.