Sunteți pe pagina 1din 7

General Motors

Infotainment SDK Setup Guide








Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 2 of 7

Table of Contents
1. Introduction 3
1.1 Copyright Notice 3
1.2 Purpose 3
2. SDK Setup 4
2.1 Assumptions 4
2.2 Prerequisites 4
2.3 Setup/Installation Process 4
3. Disclaimer 7
4. Issues/Bugs/Access 7
Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 3 of 7

Release Notes
1. Introduction
1.1 Copyright Notice

Copyright GM
Copyright 2012 GM Global Technology Operations LLC.
All rights reserved.

1.2 Purpose
The purpose of this document is to provide a set of general installation/setup process
guidelines for developers who will be using the SDK to develop GM Infotainment
applications.


Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 4 of 7

2. SDK Setup

2.1 Assumptions
It is assumed that the reader is comfortable and familiar with building applications in
Eclipse.

2.2 Prerequisites
1) The following resources are required in order to use the SDK. Refer to platform-specific
sections for version information.
1) Google Chrome web browser with the Java plugin enabled. The emulator that the
SDK uses runs in a custom Chromium build. For Mac users, it is necessary to use
Java version 6 as version 7 (the most recent) is not compatible with 32-bit Chrome
for Mac.
2) Eclipse IDE (Eclipse IDE for Java EE Developers)
3) GStreamer this comes preinstalled on most Linux builds, however it is necessary
to install the plugin for both Windows and Mac if audio playback is required for
testing an app in the emulator.
2) An Internet connection is required to successfully install the SDK.

2.3 Setup/Installation Process

Mac OSX
1) Install Google Chrome (v 23.0.1271.95) and enable/configure the Java plugin. The
Emulator uses a custom Chromium build. In order for the Java plugin to work with
Chrome, Java version 6 must be used rather than 7 (which is the most recent). For help
on reverting Java to version 6, go to:
http://support.apple.com/kb/HT5559?viewlocale=en_US

2) Install the Eclipse IDE (Eclipse Java EE IDE for Web Developers/Juno Service Release
1). It can be obtained from the official Eclipse download page
www.eclipse.org/downloads/

3) Open up Eclipse go to Help > Install New Software. Click Add. Select Archive and then
browse to the Smart Radio SDK within the local file directory
(com.gm.sdk.public.XXXXXXXX). Click Select All. Click Next. Click Next. Select I
accept! and then click Finish. Click OK for the security warning. Click Restart Now.

4) After restarting Eclipse, you can build a new project using the SDK. To create a new
project using the SDK, go to File > New > Project > New Dashboard Web Application
Project. Select the Code Samples Project. Click Next. Select all of the required Project
Facets and then click Next. By default an HTML, CSS and JavaScript file will be
generated for the project. Rename them from their default names if desired. Click
Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 5 of 7

Finish. Go ahead and open the associated GM perspective when the prompt appears.
This is not required, but recommended as it includes a useful Snippets panel with all of
the available GM SDK APIs.

5) At this point you can write code using the SDK and test your project in the emulator.
Click debug to run the application in the emulator. If the emulator does not launch on
the first attempt, switch to the Debug perspective tab on the right of the screen above
the Snippets panel. Now launch the emulator via the debug button. After the emulator
has launched once, it can be re-launched from any perspective.

6) For audio playback to work in the Emulator, the GStreamer plugin is required. At the
time this document was written, a binary installer was obtainable here:
http://itee.uq.edu.au/~davel/gstreamer/ (version 0.10.29). Java 6 (1.6.x) is also required.
Downgrade to Java 6 if necessary.

If a different version is required, a custom build can be built using MacPorts. GStreamer
is only required for testing audio playback in the Emulator.




Windows XP
1) Install Google Chrome (v 23.0.1271.95) and enable/configure the Java plugin. The
Emulator uses a custom Chromium build.

2) Install the Eclipse IDE (Eclipse Java EE IDE for Web Developers/Juno Service Release
1). It can be obtained from the official Eclipse download page
www.eclipse.org/downloads/

3) Open up Eclipse go to Help > Install New Software. Click Add. Select Archive and then
browse to the Smart Radio SDK within the local file directory
(com.gm.sdk.public.XXXXXX). Click Select All. Click Next. Click Next. Select I
accept! and then click Finish. Click OK for the security warning. Select Yes to have
Eclipse restart immediately.

4) After Eclipse restarts, you can create a new project using the SDK. To create a new
project using the SDK, go to File > New > New Dashboard Web Application Project.
Name the new project and then click Next. Select the Code Samples Project. Then
click Next. Select all of the required Project Facets and then click Next. By default an
HTML, CSS and JavaScript file will be generated for the project. Rename them from
their default names if desired. Click Finish. Go ahead and open the associated GM
perspective when the prompt appears. This is not required, but recommended as it
includes a useful Snippets panel with all of the available GM SDK APIs.

5) At this point you can write code using the SDK and test your project in the emulator.
Click the debug button to run the project in the emulator. If the emulator doesnt
Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 6 of 7

launch, switch to the debug perspective and the click the debug button. After the
emulator has launched once, it can be re-launched from any perspective.

6) For audio playback to work in the Emulator, the GStreamer plugin is required. The
Windows version used when this document was written was GStreamer-WinBuilds-
GPL-x86-Beta04-0.10.7 (v0.10.7). Windows GStreamer builds are available at:
http://code.google.com/p/ossbuild/downloads/list. Java 6 (1.6.x) is also required.
Downgrade to Java 6 if necessary. The GStreamer plugin is only necessary for testing
audio playback in the Emulator.


Linux
1) Install Google Chrome (google-chrome-stable) and enable/configure the Java plugin.
First Java needs to be installed and then the plugin enabled/configured for Chrome.
Refer to the gstreamer section (6) below.

2) Install the Eclipse IDE (Eclipse Java EE IDE for Web Developers/Juno Service Release
a) It can be obtained from the official Eclipse download page
www.eclipse.org/downloads/
b) Download 32/64 bit according to the OS architecture .

3) Open up Eclipse go to Help > Install New Software. Click Add. Select Archive and then
browse to the Smart Radio SDK within the local file directory
(com.gm.sdk.public.XXXXXXXX). Click Select All. Click Next. Click Next. Select I
accept! and then click Finish. Click OK for the security warning. Select Yes to have
Eclipse restart immediately.

4) After Eclipse restarts, you can create a new project using the SDK. To create a new
project using the SDK, go to File > New > Other > New Dashboard Web Application
Project. Name the new project and then click Next. Select the Code Samples Project.
Click Next. Select all of the required Project Facets and then click Next. By default an
HTML, CSS and JavaScript file will be generated for the project. Rename them from
their default names if desired. Click Finish. Go ahead and open the associated GM
perspective when the prompt appears. This is not required, but recommended as it
includes a useful Snippets panel with all of the available GM SDK APIs.

5) At this point you can write code using the SDK and test your project in the emulator.
Click the debug button to run the project in the emulator. If the emulator doesnt
launch, switch to the debug perspective by clicking the add perspective icon beside
the currently open perspectives. From the debug perspective, click the debug button.
After the emulator has launched once, it can be re-launched from any perspective.

6) Installation Java-6
a. GM SDK requires jdk-6 and jre-6 plugins to work.
b. Install sun-jdk-6 (Java -7 / Open JDK is not supported as of now)
Infotainment
Document Version: 1.2
SDK Setup Guide Date: 12/11/2012

GM Confidential Page 7 of 7


Reload Chrome, Open http://www.java.com/en/download/testjava.jsp to check if the
plugin works (Ignore the update warning and continue with run this time )

7) For audio playback to work in the Emulator, the GStreamer plugin is required. Most
builds of Ubuntu include GStreamer (base set) but additional libraries are required for
chrome plugins to work .
a. The necessary files are required to be downloaded in order them to work.
b. You need these gstreamer plugins
l. sudo apL-geL lnsLall llbgsLreamer0.10-dev
ll. sudo apL-geL lnsLall llbgsLreamer-pluglns-base0.10
lll. sudo apL-geL lnsLall llbgsLream-pluglns-base0.10-dev

Additionally, older versions of Ubuntu that use GStreamer version 0.1, the following
plugins are required including:

- gstreamer0.10-plugins-ugly
- gstreamer0.10-plugins-ugly-multiverse
- gstreamer0.10-plugins-bad
- gstreamer0.10-plugins-bad-multiverse
- gstreamer0.10-ffmpeg


3. Disclaimer
There is no guarantee that following these exact steps will produce the expected results in
every platform/version combination. There is also a possibility that additional steps may be
required to make the SDK functional within a specific users system.


4. Issues/Bugs/Access
Any issues, concerns or questions regarding the GM SDK should be posted to the GM SDK
developer forum

S-ar putea să vă placă și