From b20f9e74ca10cecd0a907dd63b596418af440268 Mon Sep 17 00:00:00 2001 From: theresalech Date: Fri, 10 Mar 2017 10:30:41 -0500 Subject: Update README.md Added link to https://github.com/smartdevicelink/sdl_evolution/blob/master/proposals_versus_issues.md --- README.md | 1 + 1 file changed, 1 insertion(+) (limited to 'README.md') diff --git a/README.md b/README.md index 7ef64df1cf..ee1d4fc57b 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ Pull Requests Welcome! * [Transport Manager Programming Guide](https://smartdevicelink.com/en/guides/core/transport-manager-programming/) * [Software Detailed Design](https://app.box.com/s/ohgrvemtx39f8hfea1ab676xxrzvyx1y) * [Integration Guidelines](https://smartdevicelink.com/en/docs/hmi/master/overview/) + * [Evolution Proposals versus Issues](https://github.com/smartdevicelink/sdl_evolution/blob/master/proposals_versus_issues.md) ## SDL Core -- cgit v1.2.1 From 9d2148a9ba9edc814654b97b70c4a0f999ebcf8b Mon Sep 17 00:00:00 2001 From: jacobkeeler Date: Thu, 8 Jun 2017 13:32:22 -0400 Subject: Updated README and included messages in start script for clarity --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index ee1d4fc57b..f7a0f6763f 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ Once SDL Core is compiled and installed you can start it from the executable in ``` %cd bin/ -%LD_LIBRARY_PATH=. ./smartDeviceLinkCore +%./start.sh ``` ## Start WEB HMI @@ -73,6 +73,11 @@ The dependencies for SDL Core vary based on the configuration. You can change SD |Testing framework|Needed to support running unit tests|libgtest-dev| |Cmake|Needed to configure SDL prior to compilation|cmake| +#### Sample Policy Manager +The included sample policy manager (for use with `EXTERNAL_PROPRIETARY` policy mode) requires the following packages: + - python-pip + - python-dev + ### Known Dependency Issues * log4cxx - We know that the version of log4cxx on a linux machine can conflict with the one used, which is why it is provided in the repository. To avoid the conflict, we recommend removing liblog4cxx*. * cmake - on some versions of linux, the included cmake package doesn't have the right version. If apt-get is your package manager, you can find the correct version using -- cgit v1.2.1 From eb8da353032082928b90d3820bcbb98eda08ad98 Mon Sep 17 00:00:00 2001 From: Jacob Keeler Date: Fri, 22 Sep 2017 11:38:33 -0400 Subject: Remove app launching guide from README It is confusing to keep it here, it will be moved to the Wiki. Also removing Travis Badge since it is no longer used for CI. --- README.md | 52 +--------------------------------------------------- 1 file changed, 1 insertion(+), 51 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index f7a0f6763f..a3f08e3fc1 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,6 @@ [![Slack Status](http://sdlslack.herokuapp.com/badge.svg)](http://slack.smartdevicelink.com) -[![Build Status](https://travis-ci.org/smartdevicelink/sdl_core.svg?branch=master)](https://travis-ci.org/smartdevicelink/sdl_core) - - [![codecov.io](https://codecov.io/github/smartdevicelink/sdl_core/coverage.svg?branch=develop)](https://codecov.io/github/smartdevicelink/sdl_core?branch=develop) +[![codecov.io](https://codecov.io/github/smartdevicelink/sdl_core/coverage.svg?branch=develop)](https://codecov.io/github/smartdevicelink/sdl_core?branch=develop) # SmartDeviceLink (SDL) @@ -121,54 +119,6 @@ There are several RPCs that are "required" to be implemented in order for SDL to * OnSystemRequest * Speak -## App Launching - -Below are instructions for testing app launching and query with a full system set up. - -### SDL Server -The app querying specification defines an endpoint within Policies where sdl_core will reach out to receive a list of applications that can be launched. The SDL Server provides the back end functionality for app launching and querying. - -You can find the SDL Server on [GitHub](https://github.com/smartdevicelink/sdl_server). The README contains detailed instructions for installing and launching the server. Launch the server on your local machine, and direct your browser to http://localhost:3000. - -The [App Launching Server Specification](https://github.com/smartdevicelink/sdl_server/blob/master/docs/application_launching_v1.0.md) defines an endpoint `/applications/available/:moduleId.json` which return a list of applications available for launching to the handset for filtering. - -To check if there is a module already available you can go to http://localhost:3000/modules.json. If there is a module available, there will be one or more objects in the response array. Keep this response, you'll need the "_id" field for later. - -If there is not a module already available, go to http://localhost:3000/cars and define a new vehicle, then check http://localhost:3000/modules.json. - -Next, you'll need to define applications that can be launched. Go to http://localhost:3000/apps and define some applications. Make sure that you define a url scheme under the iOS tab of the application. This is required for an application to be launched from SDL. A URL scheme has the format `someScheme://`. Save the URL Scheme you used for later steps. - -You'll also need the local ip address of your machine - -At the end of the SDL Server set up you should have - 1. SDL Server running on your local machine connected to mongo db - 2. Your machine's local IP Address - 3. The module id of your vehicle - 4. The URL Scheme of the app you want to launch - -### Mobile -You need at least one app installed on the test device (presumably an iPhone), which we have built for you, the [V4Tester application](https://app.box.com/s/eeloquc0fhqfmxjjubw7kousf12f3pzg). This application implements SDL 4.0 and will respond to SDL Core's QUERY_APPS system request, as well as filter the response for available applications. If you do not have any other applications on the device, you can only test QUERY_APPS functionality, in which no applications will be sent to sdl core which can be launched. - -In order to support the launching of an application, you'll have to create an additional app which responds to the URL Scheme of the application that you set up on the SDL Server. To do so, go to Xcode, select File>New>Project... and under ios/application create a Single View Application. Open the application's Info.plist file (under the Supporting Files section of the project explorer by default). Highlight the Information Property List item and click the plus button to add a new entry to the Property List. From the drop down menu, select URL Types as the key. In the Item 0 dictionary add a "URL Schemes" Array, and make Item 0 in the array the prefix to the URL you previously defined (So if you defined `someScheme://` then Item 0 should be "someScheme"). Make sure the URL identifier matches your application's identifier. When you're finished you should have something that looks like the following. Install this application on your test device. **Note** - this application will only launch during this process, since it is not SDL Connected it will not register with the head unit. - -![Plist Example](http://i.imgur.com/AFyJlZQ.png) - -At the end of the Mobile device set up you should have - 1. The V4 Tester Application installed on your device - 2. An application for launching that matches the application submitted to SDL Server - 3. Your iPhone should be on the same network as the machine running SDL Server - -### SDL Core -Take the following steps to launch applications from sdl core. - - 1. Install the [correct version of SDL Core](https://github.com/smartdevicelink/sdl_core/pull/39) - 2. Add the queryAppsUrl that you saved during sdl server set up in the src/appMain/preloaded_pt.json under the "endpoints" property in the format `http://[local machine ip]:3000/applications/available[moduleId].json`. For example `http://192.168.0.150:3000/applications/available/789b739c47c7490321058200.json`. - 3. Run SDL Core - 4. Launch the V4 Tester application on the iPhone - 5. Connect the application via wifi by entering the IP address of Core into the V4 tester - 6. Both applications should show up on the head unit for launching - 7. Select the other application, and you should see it launched and brought to the foreground on the phone - ## Test Coverage ### Used technologies * GCOV - test coverage program. -- cgit v1.2.1 From c1557903ddefeed660a581410442fe50490d1bb0 Mon Sep 17 00:00:00 2001 From: jacobkeeler Date: Thu, 1 Feb 2018 10:42:03 -0500 Subject: Remove references to QT HMI --- README.md | 1 - 1 file changed, 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index a3f08e3fc1..71fbf1a92d 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,6 @@ The dependencies for SDL Core vary based on the configuration. You can change SD | Flag | Description | Dependencies | |------|-------------|--------------| |Web HMI|Use HTML5 HMI|chromium-browser| -|HMI2|Build with QT HMI|QT5, dbus-*dev| |EXTENDED_MEDIA_MODE|Support Video and Audio Streaming|Opengl es2, gstreamer1.0*| |Bluetooth|Enable bluetooth transport adapter|libbluetooth3, libbluetooth-dev, bluez-tools| |Testing framework|Needed to support running unit tests|libgtest-dev| -- cgit v1.2.1