An Android Studio Multi-Window Split-Screen and Freeform Tutorial

From Techotopia
Revision as of 20:19, 2 September 2016 by Neil (Talk | contribs) (Adding the Second Activity)

Jump to: navigation, search

With the basics of Android multi-window support covered in the previous chapter, this chapter will work through the steps involved in implementing multi-window support within an Android app. This project will be used to demonstrate the steps involved in configuring and managing both split-screen and freeform behavior within a multi-activity app.

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book


Contents


Creating the Multi-Window Project

Start Android Studio and create a new project, entering MultiWindow into the Application name field and ebookfrenzy.com as the Company Domain setting before clicking on the Next button.

On the form factors screen, enable the Phone and Tablet option and set the minimum SDK setting to API N: Android N (N). Continue through the remaining setup screens, requesting the creation of an Empty Activity named FirstActivity with a corresponding layout file named activity_first.

Designing the FirstActivity User Interface

The user interface will need to be comprised of a single Button and a TextView. Within the Project tool window, navigate to the activity_first.xml layout file located in app -> res -> layout and double click on it to load it into the Designer tool. Refer to the Component Tree panel and, if the parent layout is a RelativeLayout, right-click on the entry in the tree and select the Convert RelativeLayout to ConstraintLayout menu option. Accept the default settings in the resulting panel and wait for the project to rebuild.

With the tool in Design mode, select and delete the Hello World! TextView object.

With Autoconnect mode enabled in the Designer toolbar, drag a TextView widget from the palette and position it in the center of the layout. Next, drag a Button object and position it beneath the TextView. Edit the text on the Button so that it reads “Launch”. On completion of these steps, the layout should resemble that shown in Figure 54-1:


Android Studio multi-window example UI

Figure 54-1


In the properties panel, change the widget ID for the TextView to @id/myTextView and assign an onClick property to the button so that it calls a method named launchIntent when selected by the user.

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book


Adding the Second Activity

The second activity will be launched when the user clicks on the button in the first activity. Add this new activity by right-clicking on the com.ebookfrenzy.multiwindow package name located in app -> java and select the New -> Activity -> Empty Activity menu option to display the New Android Activity dialog.

Enter SecondActivity into the Activity Name and Title fields and name the layout file activity_second. Since this activity will not be started when the application is launched (it will instead be launched via an intent by FirstActivity when the button is pressed), it is important to make sure that the Launcher Activity option is disabled before clicking on the Finish button.

Open the layout for the second activity (app -> res -> layout -> activity_second.xml) and Open the layout for the second activity (app -> res -> layout -> activity_second.xml) and convert the layout to a ConstraintLayout if necessary. Drag and drop a TextView widget so that it is positioned in the center of the layout. Edit the text of the TextView so that it reads “Second Activity”:


Android Studio multi-window example UI

Figure 54-2

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book

Launching the Second Activity

The next step is to add some code to the FirstActivity.java class file to implement the launchIntent() method. Edit the FirstActivity.java file and implement this methods as follows:

package com.ebookfrenzy.multiwindow;

import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;

public class FirstActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_first);
    }

    public void launchIntent(View view) {
        Intent i = new Intent(this, SecondActivity.class);
        startActivity(i);
    }
}

Compile and run the app and verify that the second activity is launched when the Launch button is clicked.

Enabling Multi-Window Mode

Edit the AndroidManifest.xml file and add the directive to enable multi-window support for the app as follows:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.ebookfrenzy.multiwindow">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity 
            android:name=".FirstActivity"
            android:resizeableActivity="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity android:name=".SecondActivity"></activity>
    </application>

</manifest>

Note that, at the time of writing, multi-window support is enabled by default. The above step, however, is recommended for the purposes of completeness and to defend against the possibility that this default behavior may change in the future.

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book

Testing Multi-Window Support

Build and run the app once again and, once running, press and hold the Overview button as outlined the chapter entitled An Introduction to Android 7 Multi-Window Support to switch to split-screen mode. From the Overview screen in the second half of the screen, choose an app to appear in the adjacent panel:


Android 7 split-screen example

Figure 54-3


Click on the Launch button and note that the second activity appears in the sample panel as the first.

If the app is running on a device or emulator session that supports freeform mode, press and hold the Overview button a second time until multi-window mode exits. Click in the Overview button once again and, in the resulting Overview screen, select the freeform button located in the title bar of the MultiWindow app as outlined in Figure 54-4:


Android 7 freeform button

Figure 54-4


Once selected, the activity should appear in freeform mode as illustrated in Figure 54-5:


Android 7 freeform window

Figure 54-5


Click on the Launch button and note that, once again, the second activity appears in place of the first rather than in a separate window.

In order for the second activity to appear in a different split-screen panel or freeform window, the intent must be launched with the appropriate flags set.

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book

Launching the Second Activity in a Different Window

To prevent the second activity from replacing the first activity the launchIntent() method needs to be modified to launch the second activity in a different task stack as follows:

public void launchIntent(View view) {
    Intent i = new Intent(this, SecondActivity.class);

    i.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT|
            Intent.FLAG_ACTIVITY_MULTIPLE_TASK|
            Intent.FLAG_ACTIVITY_NEW_TASK);
    
    startActivity(i);
}

After making this change, rerun the app, enter split-screen mode and launch the second activity. The second activity should now appear in the panel adjacent to the first activity:


Android 7 second activity in adjacent split-screen window

Figure 54-6


Repeat the steps from the previous section to enter freeform mode and verify that the second activity appears in a separate window from the first as shown in Figure 54-7:


Android 7 freeform window in center

Figure 54-7

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book

Changing the Freeform Window Position and Size

Each time the second activity has launched in a separate window in freeform mode it has appeared in the center of the screen. As a final example, modify the lauchIntent() method to configure the second activity so that it appears in the top left hand corner of the screen with dimensions of 100 by 100:

package com.ebookfrenzy.multiwindow;

import android.app.ActivityOptions;
import android.content.Intent;
import android.graphics.Rect;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;


import static com.ebookfrenzy.multiwindow.R.id.myTextView;

public class FirstActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_first);
    }

    public void launchIntent(View view) {
        Intent i = new Intent(this, SecondActivity.class);

        i.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT|
                Intent.FLAG_ACTIVITY_MULTIPLE_TASK|
                Intent.FLAG_ACTIVITY_NEW_TASK);

        Rect rect = new Rect(0, 0, 100, 100);

        ActivityOptions options = ActivityOptions.makeBasic();
        ActivityOptions bounds = options.setLaunchBounds(rect);

        startActivity(i, bounds.toBundle());

    }

Run the app one last time, enter freeform mode and launch the second activity. Verify that the size and position of the second window matches the specified configuration options.

Summary

This chapter has demonstrated some of the basics of enabling and working with multi-window support within an Android app through the implementation of an example project. In particular, this example has focused enabling multi-window support, launching a second activity into a new task stack and configuring the size and location of a freeform window.

You are reading a sample chapter from the Android Studio 2.2 Edition book.

Purchase the fully updated Android Studio Hedgehog Edition of this publication in eBook ($32.99) or Print ($49.99) format

Android Studio Hedgehog Essentials - Java Edition Print and eBook (PDF) editions contain 87 chapters and over 800 pages
Buy Print Preview Book