You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ag...@apache.org on 2014/05/06 21:29:22 UTC
[08/34] git commit: Adding LICENSE and README.
Adding LICENSE and README.
Project: http://git-wip-us.apache.org/repos/asf/cordova-app-harness/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-app-harness/commit/44e35976
Tree: http://git-wip-us.apache.org/repos/asf/cordova-app-harness/tree/44e35976
Diff: http://git-wip-us.apache.org/repos/asf/cordova-app-harness/diff/44e35976
Branch: refs/heads/master
Commit: 44e359762103ea315d0ecaa16a251dd0d02874aa
Parents: eb25f71
Author: Braden Shepherdson <br...@gmail.com>
Authored: Fri Jan 24 10:12:29 2014 -0500
Committer: Braden Shepherdson <br...@gmail.com>
Committed: Fri Jan 24 10:12:29 2014 -0500
----------------------------------------------------------------------
LICENSE.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
README.md | 36 ++++++++++++++++++++++++++++++++++++
2 files changed, 85 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-app-harness/blob/44e35976/LICENSE.md
----------------------------------------------------------------------
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..ff504ad
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,49 @@
+This repository contains original Cordova plugin code, and NanoHTTPD.
+
+The license of the original plugin code follows immediately, and the NanoHTTPD license is included after.
+The NanoHTTPD license is also included in `src/android/nanohttpd/LICENSE.md`.
+
+Copyright (c) 2014 The Chromium Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+ * Neither the name of Google Inc. nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+And the license for NanoHTTPD:
+
+Copyright (c) 2012-2013 by Paul S. Hawke, 2001,2005-2013 by Jarno Elonen, 2010 by Konstantinos Togias
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of the NanoHttpd organization nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
http://git-wip-us.apache.org/repos/asf/cordova-app-harness/blob/44e35976/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..61ff8c9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# App Harness Push
+
+This is a [Cordova](http://cordova.io) plugin that integrates with the [App Harness](https://git-wip-us.apache.org/repos/asf/cordova-app-harness.git) to allow pushing new versions of your app over HTTP. This enables live reloading functionality, though making the request is currently the user's responsibility to do manually with `curl`, etc. The plan is to have integration with `cordova watch` or similar, and with [Spark](https://github.com/dart-lang/spark).
+
+## Installation
+
+ cordova plugin add https://github.com/MobileChromeApps/harness-push.git
+
+## Use
+
+**You must** press the "Start Listening" button on the main menu of the App Harness prior to using any of the requests below.
+
+There are currently three requests you can make:
+
+### Push - `cordova serve`
+
+Make a `POST` request to
+
+ /push?type=serve&name=com.example.YourApp&url=http://192.168.1.101:8000
+
+and this will cause the App Harness to return to the main menu, and fetch the app from `cordova serve`.
+
+### Push - `.crx` files
+
+TODO
+
+### Menu - Return to the App Harness menu
+
+Sometimes, especially on emulators, it's hard or impossible to do the three-point touch that triggers the App Harness context menu. Sending a `POST` request to `/menu` will return to the App Harness main menu.
+
+### Exec - Run arbitrary Javascript
+
+This allows the sending of arbitrary Javascript. This is useful for debugging and may be removed later. Contact us with any interesting use-cases for this endpoint.
+
+ /exec?code=location='file:///android_asset/www/someotherpage.html'
+