Customizing an Android* OS with Intel Build Tool Suite for ... · Intel BTS provides a simple means to customize the OEM partition for an Android* Lollipop OS and then flash it to

Customizing an Android* OS with Intel®Build Tool Suite for Android* v1.1Process Guide

May 2015, Revision 1.5

Revision: 1.5 May 2015

2

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.

A “Mission Critical Application” is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS.

Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined”. Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information.

The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.

Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.

Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or go to: http://www.intel.com/design/literature.htm

Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

*Other names and brands may be claimed as the property of others.

Copyright © 2015, Intel Corporation. All rights reserved.

May 2015 Revision: 1.5

3

Revision History

Revision History

Date Revision Description

May 2015 1.5 Revised screenshots, updated Android device setup procedures, and corrected minor errors.

April 2015 1.4 Revised screenshots

April 2015 1.3 Corrected typographic and procedural errors, revised screenshots and process steps for updated software build, added process steps for removing apps, and clarified the process to enable OEM unlocking

April 2015 1.2 Updated all screenshots and added workflow for customizing OEM partition without selecting OS module.

January 2015 1.1 Added flashing information and custom OS module layout information. Reorganized content.

January 2015 1.0 Administrative edit

December 2014 0.5 Initial release

Contents


4

Contents

1 Introduction to Intel® Build Tool Suite for Android* .............................................51.1 Basic Function Description .......................................................................................................5

1.2 General Workflow.........................................................................................................................5

1.3 Supported Devices.......................................................................................................................5

2 Installing Intel® Build Tool Suite for Android*..........................................................62.1 Installing Intel BTS on Windows ............................................................................................6

2.2 Next Steps........................................................................................................................................6

3 Customizing an OEM Partition........................................................................................73.1 Create a Project in Intel® BTS...................................................................................................7

3.2 Customize an OEM Partition ....................................................................................................9

3.3 Build and Flash an OEM Partition Image ......................................................................... 14

4 Customizing an OS Module using Intel® Build Tool Suite for Android* .....174.1 Downloading the OS Module................................................................................................ 17

4.2 Create a Project in Intel BTS ................................................................................................. 18

4.3 Select an OS................................................................................................................................. 19

4.4 Customizing the Operating System................................................................................... 22

4.5 Build the OS Image ................................................................................................................... 28

4.6 Flash the Device ......................................................................................................................... 294.6.1 Unlocking a Device..................................................................................................................................294.6.2 Flashing a Device .....................................................................................................................................31

4.7 Export Factory Archive ............................................................................................................ 33

A Boot Animation File..........................................................................................................34A.1 desc.txt ........................................................................................................................................... 34

A.2 Additional Resources ............................................................................................................... 35


5

Introduction to Intel® Build Tool Suite for Android*

1 Introduction to Intel® Build Tool Suite for Android*

This chapter explains Intel® BTS and how it can be used.

1.1 Basic Function Description

Intel BTS comprises several tools and scripts into one application. The graphical user interface makes it easy to access the functions of tools without requiring the expertise needed to use many separate command-line interfaces.

1.2 General Workflow

Intel BTS provides a simple means to customize the OEM partition for an Android* Lollipop OS and then flash it to a device.

As an option, you can select a different build of Lollipop and flash that to the device along with your OEM partition customizations.

Intel BTS can not be used to build a custom OS image.

1.3 Supported Devices

Intel BTS can only flash standard Android tablets. Other devices, such as MinnowBoard MAX development boards or Android phones can not be flashed with Intel BTS.

Installing Intel® Build Tool Suite for Android*


6

2 Installing Intel® Build Tool Suite for Android*

This chapter explains the process to install Intel® BTS.

2.1 Installing Intel BTS on Windows

Intel BTS has been designed for use with Windows* 7. If you are running Windows* 8.x, Intel BTS is intended for use in desktop mode.

1. Copy the installer (such as bts-1.1.0.<datecode>.exe) to your hard drive.

2. Navigate to the location where you saved the installer. Double-click to start the installer. Follow the onscreen prompts.

3. When prompted to choose components to install, if you do not have Phone Flash Tool installed, select Phone Flash Tool.

Note: If you are unsure whether Phone Flash Tool is installed on your computer, select the option to install it. The installer will skip previously installed components.

2.2 Next Steps

To customize an OEM partition without specifying an OS image, see Chapter 3.

To customize an OS image, Chapter 4.


7

Customizing an OEM Partition

3 Customizing an OEM Partition

This chapter explains the steps to customize an OEM partition using Intel® Build Tool Suite for Android* without selecting an Android* operating system (OS) Module.

3.1 Create a Project in Intel® BTS

1. Start Intel BTS.The main window, as shown in the example below, is displayed.

2. Click Start new project.



8

3. In the New Project dialog, specify a name for your project.

4. Click Create project.The project window opens, with the Boot animation panel displayed.

Since an OS has not yet been specified, the project window displays Android* 5.x, Lollipop as the OS. You may continue customizing the OEM partition without choosing an OS. To choose an OS, refer to Chapter 4, “Customizing an OS Module using Intel® Build Tool Suite for Android*”.


9


3.2 Customize an OEM Partition

1. There are four customization panels, Boot animation, Theme, Apps, and Settings. In the Left Navigation pane, click the Panel buttons to display the Customization panels.

2. To specify a Boot animation file, on the Boot animation panel, click the “+”.



10

3. To select a different wallpaper to be displayed on the device, click Theme. The Wallpaper panel is displayed.

Note: To preview the wallpaper in landscape and portrait mode, hover your cursor over one of the wallpapers in the palette, as shown below:


11


4. Select one of the pre-loaded wallpaper images or click the “+” to navigate to a folder that contains a wallpaper image. Customizing a Lollipop OS allows you to add Live wallpaper apps by clicking the lower “+”, as shown in the screenshot below:

Note: If you add a live wallpaper app and do not intend to select an OS to customize, after flashing the OEM partition, you must do a factory reset to see the live wallpaper app on the device.

5. To deselect a wallpaper, in the palette, click the selected wallpaper, as shown below:

6. To add apps to the customization, click Apps. The Apps selection panel is displayed.



12

7. To select apps to be added to the customization, click the “+” as shown below:

Apps that are added to the OS image are displayed in the Apps panel, as shown below.

Note: The app files should be standard Android APK files.

8. To remove all apps, click the circle arrow button, as shown in the example above. To remove individual apps, click the trash can icon.

a. The app icons display a Select circle.


13


b. Select the apps to be removed.

c. Click the to remove the selected apps.The selected apps are removed.

Note: If you make any changes to your customizations after you have built the OEM partition, such as to remove an app from the customization, you must rebuild the OEM partition before you can flash the device. Intel BTS will remind you of this and will give you the option to rebuild the OEM partition prior to flashing.

9. Customizing a Lollipop OS also allows you to customize the default language and region on the device by selecting Settings.



14

10. To change the settings, click the dropdown menu and select the desired language and region.

3.3 Build and Flash an OEM Partition Image

After specifying the customizations for the OEM partition, you can build the partition and flash a device. To complete this process, the device must already have an OS on it and the space for the OEM partition must be sufficient to hold the new OEM partition. For example, Intel® Reference Design for Android* images have a 100MB OEM partition. If you have flashed a device with an Intel RD for Android image, the device should provide sufficient room for a wallpaper and a small additional app.

If a newly created OEM partition exceeds the original partition size, Intel BTS will display an error message and will not flash the device. Unfortunately, there is no way to determine the size of a newly created OEM partition file prior to flashing.

1. From the Build menu, select Build OEM partition image.


15


The image is saved in the project directory in the build folder and is ready to be flashed to the device. When the build process completes, the following dialog is displayed:

• To save the image to a different location (if you plan to use a different method than Intel BTS to flash the device), click Save image and specify a location.

• To dismiss the dialog, click Ok.

2. To flash the device with the newly created OEM partition, from the Build menu, select Flash OEM partition to device.

Note: If you make any change to the customizations after you build an OEM partition, when you attempt to flash the OEM partition, the tool asks you if you want to re-build the partition:

3. Follow the on-screen directions to prepare the device for flashing.



16

The progress window displays the processes being executed on the device.

When the flash process is complete, the progress window displays “Device flashed successfully!”

4. Click OK to dismiss the progress window.


17

Customizing an OS Module using Intel® Build Tool Suite for Android*

4 Customizing an OS Module using Intel® Build Tool Suite for Android*

This chapter explains the steps to customize an Android* operating system (OS) Module.

4.1 Downloading the OS Module

This section explains steps to obtain an Android OS module and put it in a location on your Windows 7 or Windows 8 computer.

1. Locate the OS module that you wish to customize with Intel® BTS by doing one of the following actions:

• If you created a custom OS module, locate that file and skip to Section 4.2.

• If you are customizing an Intel® Reference Design for Android* OS Module, you’ll need to obtain it first. To obtain an OS module, talk to your Intel representative or log into your VIP account.

A typical OS module file will be named similarly to cohol-flashfiles-DEVICE-COHOL01000-signed.zip.

2. Download that module to a location on your computer. For the examples that follow, we used the file cohol-flashfiles-DEVICE-COHOL01000-signed.zip. Your filename may differ.

Note: Do not extract any files from the zip archive. The Intel BTS application will extract the files in a subsequent step.



18

4.2 Create a Project in Intel BTS

1. Start Intel BTS.The main window, as shown in the example below, is displayed.

2. Click Start new project.

3. In the New Project dialog, specify a name for your project.


19


4. Click Create project.The project window opens, with the Boot animation panel displayed.

4.3 Select an OS

Unless a specific OS is chosen from the installed OS modules, Intel BTS creates customizations for a generic build of Android Lollipop. Choosing another installed OS module may expose or hide different customizations. Choosing an installed OS module allows you to use Intel BTS to flash the full OS (along with your customizations) to a device.

1. To select an OS, click Select OS.



20

Intel BTS displays the Operating System panel.

2. Click Import OS.

3. Navigate to the zip file you downloaded or located in Section 4.1. Select the file and click Open.4


21


After Intel BTS finishes importing the OS module, the main window is displayed with an operating system tile to be customized. If available, the OS tile displays all the different versions of the operating system.



22

4.4 Customizing the Operating System

1. If different builds are available, choose the version of the operating system.

2. Click Select to choose an operating system to be customized.There are four customization panels, Boot animation, Theme, Apps, and Settings. To display a Customization panel, in the Left Navigation pane, click a Panel button.


23


3. Start by clicking the Boot animation.The Boot animation selection panel is displayed.

4. Click the “+” to select an animation file.

Note: The boot animation should be a zip file corresponding to the standard Android boot animation format. For more information, see "Boot Animation File" on page 34.



24

5. To select a different wallpaper to be displayed on the device, click Theme. The Wallpaper image selection panel is displayed.

Note: To preview the wallpaper in landscape and portrait mode, hover your cursor over one of the wallpapers, as shown below:


25


6. Select one of the pre-loaded wallpaper images or click the “+” to navigate to a folder that contains a wallpaper image. If you are customizing an Lollipop OS module, you may also add Live Wallpaper by clicking the lower “+”, as shown in the screenshot below:

7. To deselect a wallpaper, in the palette, click the selected wallpaper, as shown below:

8. To add apps to the customization, click Apps. The Apps selection panel is displayed.



26

9. To select apps to be added to the customization, click the “+” as shown below:

Apps that are added to the OS image are displayed in the Apps panel, as shown below.

Note: The app files should be standard Android APK files.

10. To remove all apps, click the circle arrow button, as shown in the example above. To remove individual apps, click the trash can icon.

a. The app icons display a Select circle.


27


b. Select the apps to be removed.

c. Click the to remove the selected apps.The selected apps are removed.

Note: If you make any changes to your customizations after you have built the OEM partition, such as to remove an app from the customization, you must rebuild the OEM partition before you can flash the device. Intel BTS will remind you of this and will give you the option to rebuild the OEM partition prior to flashing.

11. If you are customizing a Lollipop OS module, you may also customize the default language and region on the device by selecting Settings.



28

12. To change the settings, click the dropdown menu and select the desired language and region.

4.5 Build the OS Image

1. From the Build menu, select Build OEM Partition Image.

The image is saved in the project directory in the build folder and is ready to be flashed to the device. When the build process completes, the following dialog is displayed:

• To save the image to a different location (if you plan to use a different method than Intel BTS to flash the device), click Save image and specify a location.

• To dismiss the dialog, click Ok.S


29


4.6 Flash the Device

Use the steps in this section to flash the OS along with your customized OEM partition to the device.

4.6.1 Unlocking a Device

Prior to flashing a device, you must enable it to be unlocked by fastboot commands that will be sent to it from Intel BTS. To enable unlocking, do the following:

1. On the device, open Settings.

2. Tap About Tablet.

3. Tap Build Number seven times. If a note appears: “No need, you are already a developer” Developer Options is already available on the Settings pane under System.



30

4. In Settings, in the System group, tap Developer Options. The Developer Options pane is displayed.

Note: If there is a green box with a white check to the right of the Enable OEM unlock option, unlocking is already enabled and you may skip to “Flashing a Device” on page 31.

5. Tap OEM unlocking.A query appears on the device.


31


6. Tap Enable.A green toggle indicates OEM unlocking is enabled.

Note: The default fastboot scripts do not lock the device after the fastboot scripts are finished. While you are developing your custom OS or customizing an OS, you may choose to unlock your Android* device and leave it unlocked. In this way, you can avoid repeatedly locking and unlocking the device to test each change.

4.6.2 Flashing a Device

1. In the Intel® BTS main window, from the Build menu, select one of the options to flash the device. The differences are explained in the table below:

Table 1. Flash to Device Options

Select this Option… To Flash…

Flash OEM Partition The OEM partition onto the device (see Section 3.3)

Flash Release OS to device A final version of the OS onto the device

Flash Debug OS to device An OS that is enabled for debug



32

The Flash Release OS or Flash Debug OS progress window is displayed with instructions for preparing the device for flashing.

2. Follow the on-screen directions to prepare the device for flashing.

Note: For more information about flashing the device, consult the help from within the Phone Flash Tool itself.

The progress window displays the processes being executed on the device.

When the flash process is complete, the progress window displays “Device flashed successfully!”.


33


If the flash process fails, the progress window displays an error, similar to the example shown below:

Note: After flashing, you may need to reboot the device two times for it to properly recognize the new OS.

4.7 Export Factory Archive

After you have completed your OS module customizations, flashing, and testing, you can export the OS module to a factory archive.

1. With the completed project open in Intel BTS, from the Build menu, select Export factory archive.

2. In the Save As window, specify a location and name for the Factory archive. In the example below, we used the filename L-factory-archive.zip. You may use any filename.

3. Click Save.While the archive is being saved, the alert shown below is displayed.

When the save is complete, the project window is displayed.

Boot Animation File


34

A Boot Animation File

An Android* boot animation is a zip file containing a file desc.txt and folders with the animation frames as JPEG or PNG images.

A.1 desc.txt

The desc.txt file is the animation control file, which describes the animation and how to play the frames. The schema is:

This first line specifies the dimensions of the animation and its speed.

[width] [height] [frames per second]

p [number of loops] [delay] [folder]


35

Boot Animation File

The second line describes part of the animation. It can be duplicated as many times as required. The images in the folder are played, in order, for the duration indicated by the number of loops before going on to the next part. Zero, as the number of loops, means “display forever”. An example is shown below:

Here’s an example of a desc.txt file:

A.2 Additional Resources

• http://www.addictivetips.com/mobile/how-to-change-customize-create-android-boot-animation-guide/

-+- desc.txt

|

+- middle

| |

| +- image01.jpg

| |

| +- image02.jpg

| |

| +- image03.jpg

| |

| +- image04.jpg

| |

| +- image05.jpg

| |

| +- image06.jpg

|

+- start

| |

| +- image01.jpg

| |

| +- image02.jpg

| |

| +- image03.jpg

|

+- static

|

+- image01.jpg

1280 720 3

p 1 0 start

p 20 0 middle

p 0 0 static

http://www.addictivetips.com/mobile/how-to-change-customize-create-android-boot-animation-guide/

http://www.addictivetips.com/mobile/how-to-change-customize-create-android-boot-animation-guide/

Documents

Customizing an Android* OS with Intel Build Tool Suite for ... · Intel BTS provides a simple means to customize the OEM partition for an Android* Lollipop OS and then flash it to