Template Upload
133
node_modules/weinre/web/doc/Building.html
generated
vendored
Normal file
@ -0,0 +1,133 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Building</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Building</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p>The source repository for weinre is maintained at Apache. See the
|
||||
archives information on the <a href="Installing.html">Installing</a>
|
||||
page for more information on downloading a source archive.
|
||||
|
||||
<p>If you'd prefer to obtain the source via git, you can use one of the
|
||||
following repos:
|
||||
|
||||
<ul>
|
||||
<li>Apache repo: <td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
|
||||
<li>GitHub repo: <td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
|
||||
</ul>
|
||||
|
||||
<p>The Apache repo is the canonical repo. The url can be used in a web
|
||||
browser, or as the argument of a <tt>git clone</tt> command.
|
||||
|
||||
<p>The GitHub repo is a clone of the Apache repo, and automatically shadowed
|
||||
at some regular interval. The url is the web view of the repo, from
|
||||
which you can obtain a url to use with <tt>git clone</tt>.
|
||||
|
||||
<p>See the file
|
||||
<tt><a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git;a=blob;f=README.md;hb=HEAD">README.md<a/></tt>
|
||||
in the top-most directory of the source distribution for more instructions on
|
||||
how to perform a build. A <a href="https://github.com/apache/cordova-weinre/blob/master/README.md">markdown-processed version of the README file
|
||||
is available on GitHub</a>.
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
372
node_modules/weinre/web/doc/ChangeLog.html
generated
vendored
Normal file
@ -0,0 +1,372 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - ChangeLog</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - ChangeLog</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2012/??/?? - version 2.0.0</h2>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><p>port the server from Java to node.js
|
||||
<li><p>lots of other changes
|
||||
|
||||
</ul>
|
||||
|
||||
<p>issues resolved:
|
||||
<ul>
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-10">CB-10</a> - Apache source headers in callback-weinre
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-36">CB-36</a> - move/delete GitHub issues at phonegap/weinre and callback/callback-weinre into the Apache Callback JIRA
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-83">CB-83</a> - implement the server in node
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-100">CB-100</a> - fix issues regarding pre-req licenses for weinre distribution
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-175">CB-175</a> - error when XHR contentType is null
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-176">CB-176</a> - add vendor files to weinre instead of pulling in at build time
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-182">CB-182</a> - error when XHR contentType is null
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-232">CB-232</a> - rename assets from PhoneGap to Cordova
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-257">CB-257</a> - the README.md in the weinre-node distribution is bogus
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-259">CB-259</a> - create a weinre tarball as a build archive that is npm install-able
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-266">CB-266</a> - weinre runtime error if you don't have a ~/.weinre/server.settings file
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-284">CB-284</a> - invocation exception on WeinreClientEventsImpl.connectionCreated(): TypeError: Cannot read property 'url' of undefined
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-288">CB-288</a> - re-version as 2.0.0
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-293">CB-293</a> - bullet-proof modjewel
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-294">CB-294</a> - various exceptions thrown in the target in WeinreTargetEventsImpl.connectionCreated()
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-315">CB-315</a> - generate valid Apache release artifact names
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-540">CB-540</a> - ability to easily navigate to particular place in DOM via bookmarks/jump to selector
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-604">CB-604</a> - weinre doesn't work in strict mode
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-873">CB-873</a> - setTimeout() and setInterval() usage with string arguments is busted
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-984">CB-984</a> - cannot install weinre with Node 0.8.0
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-1666">CB-1666</a> - "INVALID_STATE_ERR: DOM Exception 11" with chbrody/Cordova-SQLitePlugin
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-1759">CB-1759</a> - doc indicates that you should launch weinre with a command prefix of `node`
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-1193">CB-1193</a> - add Windows Phone support
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-1800">CB-1800</a> - remove references to "incubator"
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-1494">CB-1494</a> - Supports running server behind a proxy, such as Heroku Cedar
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-2650">CB-2650</a> - Weinre style inspection breaks with normalize.css
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-3319">CB-3319</a> - Chrome is setting window properties which now breaks Weinre
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-3328">CB-3328</a> - chrome version >= 27 breaks flex-box usage
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-3378">CB-3378</a> - support for FF and IE10
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-6991">CB-6991</a> - Weinre fails to load in browsers without a built-in development console
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-7367">CB-7367</a> - allow update of weinre id in page url without page refresh
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-7430">CB-7430</a> - weinre does not play nice with npm dedupe
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-7437">CB-7437</a> - xhr readystate event passed bad event on some platforms
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-7438">CB-7438</a> - weinre target not setting server url when from script's src attribute for https
|
||||
<li><a href="https://issues.apache.org/jira/browse/CB-5718">CB-5718</a> - Detection of HTTPS broken
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/12/01 - version 1.6.1</h2>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><p>Error handling for some built-in callbacks has been removed. This function
|
||||
was added in version 1.6.0. Unfortunately, it had some problems, and it wasn't
|
||||
clear if the fix was going to make things worse.
|
||||
|
||||
</ul>
|
||||
|
||||
<p>issues resolved:
|
||||
<ul>
|
||||
<li> <a href="https://issues.apache.org/jira/browse/CB-82"> apache/callback issue 82</a> - removeEventListener broken
|
||||
</uL>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/10/28 - version 1.6.0</h2>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><p>The Network panel has been added to weinre, which will display information
|
||||
for any XHRs that you issue.
|
||||
|
||||
<li><p>Error handling for some built-in callbacks has been added. The support
|
||||
is very similar to what's provided in the
|
||||
<a href="https://github.com/pmuellr/log-callback-error">log-callback-error project</a>,
|
||||
though the implementation is different.
|
||||
|
||||
<li><p>The element highlighter has been modified to show brighter colors.
|
||||
The colors also now more closely match the Web Inspector colors.
|
||||
Currently, there are some artifacts in the corners in some cases, but it's not
|
||||
clear to me this is a huge problem - in fact, maybe it's a feachur. ~shrug~
|
||||
As part of this clean up, I've made the element highlighter pluggable. If you
|
||||
think you can do better, it should be pretty straight-forward to code up a
|
||||
new one. Bring it on.
|
||||
|
||||
<li><p>The JavaScript code for weinre has been converted from the "scoop" DSL
|
||||
format to CoffeeScript. You no longer have a valid excuse for not hacking the
|
||||
code.
|
||||
|
||||
<li><p>The "Test Drive" page of the doc has been removed and replaced with
|
||||
the new "User Interface" page.
|
||||
|
||||
<li><p>weinre now adds an "error" listener to window. For JavaScript engines
|
||||
that support "window onerror", you will now see a message logged to the console
|
||||
when an error occurs anywhere in your JavaScript code. Unfortunately, just
|
||||
as support for "window onerror" is becoming available in JavaScript, the browsers
|
||||
are neutering it's support. Depending on your browser, you may or may not
|
||||
see these errors reported, and even if you do, they may not give you <b>any</b>
|
||||
useful information. Thanks to Ryan Seddon for supplying the following
|
||||
backgrounder links for your enjoyment:
|
||||
|
||||
<ul>
|
||||
<li><a href="http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-September/033252.html">http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-September/033252.html</a>
|
||||
<li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=568564">https://bugzilla.mozilla.org/show_bug.cgi?id=568564</a>
|
||||
<li><a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=14177">http://www.w3.org/Bugs/Public/show_bug.cgi?id=14177</a>
|
||||
<li><a href="https://bugs.webkit.org/show_bug.cgi?id=70574">https://bugs.webkit.org/show_bug.cgi?id=70574</a>
|
||||
</ul>
|
||||
|
||||
</ul>
|
||||
|
||||
<p>issues resolved:
|
||||
<ul>
|
||||
<li> <a href="https://issues.apache.org/jira/browse/CB-1"> issue apache/callback issue 1</a> - update the doc
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/41"> issue phonegap/weinre 41</a> - add support for XHRs on Network panel
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/40"> issue phonegap/weinre 40</a> - clean up spurious messages in the server console
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/38"> issue phonegap/weinre 38</a> - cleanup some of the exception handler bits
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/37"> issue phonegap/weinre 37</a> - Timeout function does not pass arguments
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/35"> issue phonegap/weinre 35</a> - convert JavaScript in weinre from scoop to CoffeeScript
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/20"> issue phonegap/weinre 20</a> - add support for window.onerror
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/19"> issue phonegap/weinre 19</a> - 404 error on /client/index.html in Mac app (incomplete build?)
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/11"> issue phonegap/weinre 11</a> - provide better error handling - by hook or by crook
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/10"> issue phonegap/weinre 10</a> - element highlighter code in the target is just awful
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/07/22 - version 1.5.0</h2>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><p>The Resources panel now includes an active Databases section. For any WebSQL
|
||||
database that you open, you should see an entry in the expanded section. For each database,
|
||||
you'll see the list of tables owned by the database when the database section
|
||||
is expanded. Note that you need to open
|
||||
the database to see it listed here. Databases which you have previously created
|
||||
in other browsing sessions will not be displayed until they are first opened.
|
||||
|
||||
<p>Clicking on a database table will dump the database contents to the panel.
|
||||
Clicking on the database itself will provide a prompter for you to run SQL
|
||||
commands against that database. For example, entering
|
||||
<tt>"select * from YourTableNameHere"</tt>
|
||||
will dump the table contents to the panel.
|
||||
|
||||
<li><p>Some of the console functions, like <tt>console.log()</tt>, were not handling
|
||||
object arguments correctly. You should now see a an object display. For example,
|
||||
typing <tt>"window"</tt> or <tt>"console.log(window)"</tt> into the console
|
||||
will show you the same object display for the window.
|
||||
|
||||
<li><p>The ant build script did not have the correctly-cased file names for some
|
||||
of the files, and the build failed. This has been fixed. You should be able
|
||||
to do a build on Linux, and other case-sensitive file systems.
|
||||
|
||||
<li><p>While weinre already removes some of the Web Inspector panels wholesale,
|
||||
there were still a number of meaningless gee-gaws on the panels that we do show.
|
||||
Those have been surgically removed with CSS.
|
||||
|
||||
</ul>
|
||||
|
||||
<p>issues closed:
|
||||
<ul>
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/7">issue 7</a> - support for WebSQL
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/8">issue 8</a> - console.log() etal don't handle object parameters
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/12">issue 12</a> - wrong-cased file names in ant scripts for Linux
|
||||
<li> <a href="https://github.com/phonegap/weinre/issues/16">issue 16</a> - hide stuff in the Web Inspector UI that's not used
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/05/09 - version 1.4.0</h2>
|
||||
<ul>
|
||||
<li> better calculation of object's class name. closes <a href="https://github.com/pmuellr/weinre/issues/41">issue 41</a>.
|
||||
<li> initial set of changes in for extensions. closes <a href="https://github.com/pmuellr/weinre/issues/8">issue 8</a>.
|
||||
<li> added json2.js to the mix; part of issue <a href="https://github.com/pmuellr/weinre/issues/45">issue 45</a>.
|
||||
<li> works with recent scooj release. closes <a href="https://github.com/pmuellr/weinre/issues/52">issue 52</a>.
|
||||
<li> add non-authenticated multi-user support. closes <a href="https://github.com/pmuellr/weinre/issues/50">issue 50</a>.
|
||||
See <a href="MultiUser.html">the MultiUser doc page</a> for more information.
|
||||
</ul>
|
||||
|
||||
<p>issues closed:
|
||||
<ul>
|
||||
<li> <a href="https://github.com/pmuellr/weinre/issues/8">issue 8</a> - enable extensions
|
||||
<li> <a href="https://github.com/pmuellr/weinre/issues/41">issue 41</a> - in JSC, inspected object's class is always "object"
|
||||
<li> <a href="https://github.com/pmuellr/weinre/issues/50">issue 50</a> - add non-authenticated multi-user support
|
||||
<li> <a href="https://github.com/pmuellr/weinre/issues/52">issue 52</a> - react to recent modjewel / scooj changes
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/04/05 - version 1.3.0</h2>
|
||||
<ul>
|
||||
<li> style editing now enabled in Elements panel
|
||||
<li> localStorage and sessionStorage views enabled in Resources panel
|
||||
<li> URLs to vendor repos updated for the weinre build
|
||||
<li> check for bad versions of Prototype.js
|
||||
</ul>
|
||||
|
||||
<p>issues closed:
|
||||
<ul>
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/21">issue 21</a> - add support for localStorage
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/35">issue 35</a> - testing local files on IOS
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/36">issue 36</a> - element.style cannot be edited
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/44">issue 44</a> - update vendor repos
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/03/12 - version 1.2.0</h2>
|
||||
<ul>
|
||||
<li> DOM elements are now updated live as they change in the target
|
||||
<li> more console support; sprintf formatting and expandable object logging
|
||||
</ul>
|
||||
|
||||
<p>issues closed:
|
||||
<ul>
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/27">issue 27</a> - edge case where programmatically created DOM is only picked up partially
|
||||
<li><a href="https://github.com/pmuellr/weinre/issues/37">issue 37</a> - console.log output doesn't do sprintf-style string interpolations
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/03/02 - version 1.1.0</h2>
|
||||
<ul>
|
||||
<li>added Timeline panel; tracks timers, intervals, XHRs, some other events, and
|
||||
<tt>console.markTimeline(<i>string</i>)</tt>
|
||||
<li>now showing matching style rules in Elements panel
|
||||
<li>no more diagnostic messages in the user's console; they are now written
|
||||
to the server console
|
||||
<li>caught up to a more recent version of Web Inspector
|
||||
<li>refactoring, technical debt paydown
|
||||
</ul>
|
||||
|
||||
<p>issues closed:
|
||||
<ul>
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/10'>issue 10</a> - enable Timeline panel, and provide some events
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/20'>issue 20</a> - catch up to latest Web Inspector code base
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/23'>issue 23</a> - mac app's web pages can't connect to server
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/24'>issue 24</a> - weinre server runs slowly on windows
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/25'>issue 25</a> - pay down technical debt
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/28'>issue 28</a> - create a standalone Java launch
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/29'>issue 29</a> - autoconnect does not always work
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/30'>issue 30</a> - all-json-idls.js is a pig
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/31'>issue 31</a> - redirect error/warn/info/debug messages from client and target to server
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/32'>issue 32</a> - monospace font too small everywhere
|
||||
<li><a href='https://github.com/pmuellr/weinre/issues/33'>issue 33</a> - update doc
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2011/01/25 - version 1.0.0</h2>
|
||||
<ul>
|
||||
<li> Don't display "not implemented" messages. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 19</a>.
|
||||
<li> Remove node highlighting cruft. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 18</a>.
|
||||
<li> Add meta element to enable GCF for client. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 17</a>.
|
||||
<li> Make bookmarklet more portable. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 16</a>.
|
||||
<li> Enable node highlighting. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 2</a>.
|
||||
<li> Change copyright statements. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 13</a>.
|
||||
<li> Change Weinre.Console to Console. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 11</a>.
|
||||
<li> Add implementation for settings. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 5</a>.
|
||||
<li> Provide better escape for // comments in minifier. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 6</a>.
|
||||
<li> Get metrics working in Elements panel. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 1</a>.
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>2010/12/16 - version 0.9.9</h2>
|
||||
|
||||
<ul>
|
||||
<li>initial release
|
||||
</ul>
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
280
node_modules/weinre/web/doc/Home.html
generated
vendored
Normal file
@ -0,0 +1,280 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Home</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Home</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p><span class="weinre">weinre</span> is <b>WE</b>b <b>IN</b>spector <b>RE</b>mote.
|
||||
Pronounced like the word "winery". Or maybe like the word "weiner". Who knows,
|
||||
really.
|
||||
|
||||
<p><span class="weinre">weinre</span> is a debugger for web pages, like
|
||||
FireBug (for FireFox)
|
||||
and
|
||||
Web Inspector (for WebKit-based browsers), except it's designed
|
||||
to work <b>remotely</b>, and in particular, to <b>allow you debug web pages
|
||||
on a mobile device such as a phone</b>.
|
||||
|
||||
<p>Interesting places to visit:
|
||||
<table>
|
||||
|
||||
<tr><td>videos at YouTube:
|
||||
<td><a href="http://www.youtube.com/results?search_query=weinre">http://www.youtube.com/results?search_query=weinre</a>
|
||||
|
||||
<tr><td>this documentation:
|
||||
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
|
||||
|
||||
<tr><td>unofficial binary packages:
|
||||
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
|
||||
|
||||
<tr><td>issues:
|
||||
<td><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?jqlQuery=project=CB+and+component=weinre">https://issues.apache.org/jira/gobble-de-gook/...</a>
|
||||
|
||||
<tr><td>create a new issue:
|
||||
<td>
|
||||
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=1">bug</a>
|
||||
or
|
||||
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=2">new feature</a>
|
||||
|
||||
<tr><td>cloneable source at Apache:
|
||||
<td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
|
||||
|
||||
<tr><td>Apache repo cloned at GitHub:
|
||||
<td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
|
||||
|
||||
<tr><td>mailing lists at Apache:
|
||||
<td><a href="http://mail-archives.apache.org/mod_mbox/cordova-dev/">http://mail-archives.apache.org/mod_mbox/cordova-dev/</a> (for weinre development)
|
||||
|
||||
<tr><td>discussion at Google Group:
|
||||
<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a> (for weinre usage)
|
||||
|
||||
</table>
|
||||
|
||||
<p>More information on <span class="weinre">weinre</span>'s big brothers, Web Inspector / Google Chrome
|
||||
Developer Tools, is available at
|
||||
<a href="http://code.google.com/chrome/devtools/docs/overview.html">Google's Chrome Dev Tools pages</a>
|
||||
and
|
||||
<a href="http://developer.apple.com/library/safari/#documentation/appleapplications/Conceptual/Safari_Developer_Guide/DebuggingYourWebsite/DebuggingYourWebsite.html">Apple's Web Inspector pages</a>.
|
||||
|
||||
<p>If you aren't familiar with FireBug or Web Inspector,
|
||||
<span class="weinre">weinre</span> isn't going to make too much sense to you.
|
||||
<span class="weinre">weinre</span> reuses the user interface code from the
|
||||
<a href="http://trac.webkit.org/wiki/WebInspector">Web Inspector project at WebKit</a>,
|
||||
so if you've used Safari's Web Inspector or Chrome's Developer Tools,
|
||||
<span class="weinre">weinre</span> will be very familiar. If you're not
|
||||
familiar with Web Inspector, the links above to Google's and Apple's documentation
|
||||
will be useful.
|
||||
|
||||
<p>Here's an example session using <span class="weinre">weinre</span>:
|
||||
|
||||
<p><img src="images/weinre-demo.jpg">
|
||||
|
||||
<p>Two screen captures are shown above. On the left is the
|
||||
<span class="weinre">weinre</span> <b>client</b> application, displaying debug
|
||||
information.
|
||||
On the right is the <b>target</b> web page, running in Mobile Safari in the iOS Simulator.
|
||||
|
||||
<p>In normal usage, you will be running the <b>client</b> application in a browser
|
||||
on your desktop/laptop, and running a <b>target</b> web page on your mobile device.
|
||||
|
||||
<p>In the session above, the debugger is display the Elements panel, with the
|
||||
embedded console expanded in the bottom third of the window. In the console
|
||||
area, we've entered two statements:
|
||||
|
||||
<pre>
|
||||
document.body.style.backgroundColor
|
||||
document.body.style.backgroundColor = "pink"
|
||||
</pre>
|
||||
|
||||
<p>The result of running the first statement shows the value of the body's background style is not set.
|
||||
The second statement sets the body's background to pink. That horrifying pink
|
||||
background is then rendered in the <b>target</b>'s window.
|
||||
|
||||
<p>In addition, an <tt>h1</tt> element is selected in the upper third of the
|
||||
Elements panel, which causes the side panels on the right to be filled in with
|
||||
relevant information. In this case, the matched CSS rules for that <tt>h1</tt>
|
||||
element are being shown.
|
||||
|
||||
<p>If you are familiar with WebKit's Web Inspector,
|
||||
a partial list of differences between it and <span class="weinre">weinre</span>
|
||||
are listed below:
|
||||
|
||||
<ul class="spaced">
|
||||
|
||||
<li><span class="weinre">weinre</span> does not make use of any 'native' code
|
||||
in the browser, it's all plain old boring JavaScript.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
|
||||
it's functionality is limited. For instance, source level debug of JavaScript
|
||||
is not <span class="strike">possible</span>
|
||||
<a href="http://lexandera.com/aardwolf/">easy</a>.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
|
||||
the debug target code will run on browsers
|
||||
without specialized debug support. For instance, a browser running on your phone.
|
||||
|
||||
<li><span class="weinre">weinre</span> supports 'remote' interaction,
|
||||
so you can run the debugger user interface on one
|
||||
machine and can debug a web page running
|
||||
on another machine. For instance, debug a web page displayed on your phone from your
|
||||
laptop.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> supports 'remote' interaction,
|
||||
multiple debug clients can be debugging the same debug target at the same time.
|
||||
|
||||
<li>One thing <b>not</b> different from Web Inspector is that the debug client
|
||||
user interface only runs on WebKit-based browsers.
|
||||
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Supported Libraries and Platforms</h2>
|
||||
|
||||
<p>Generally version numbers listed here are the earliest
|
||||
versions of the relevant thing that have been tested.
|
||||
Later versions of those things are also hopefully supported,
|
||||
but let us know.
|
||||
|
||||
<h3>Libraries not supported</h3>
|
||||
|
||||
<ul>
|
||||
<li>versions of Prototype.js before version 1.7 are not supported,
|
||||
as they do not support the <tt>JSON.stringify()</tt> API correctly. You
|
||||
will get an <tt>alert()</tt> in the web page you are debugging if you
|
||||
attempt to debug it with <span class="weinre">weinre</span> and you are using an unsupported
|
||||
version of Prototype.js.
|
||||
</ul>
|
||||
|
||||
<h3>Platforms supported - debug server</h3>
|
||||
<p>Any platform that supports <a href="http://nodejs.org/">node.js</a>.
|
||||
|
||||
<h3>Platforms supported - debug client</h3>
|
||||
<p>The browser where the debugger user interface runs.
|
||||
|
||||
<ul>
|
||||
<li>Google Chrome
|
||||
<li>Apple Safari
|
||||
<li>Other recent-ish WebKit-based browsers
|
||||
</ul>
|
||||
|
||||
<h3>Platforms supported - debug target</h3>
|
||||
<p>The browser with the page you are debugging.
|
||||
|
||||
<ul>
|
||||
<li>Android Browser application
|
||||
<li>iOS Mobile Safari application
|
||||
<li>PhoneGap/Cordova
|
||||
<li>other
|
||||
</ul>
|
||||
|
||||
<h3>Platforms not supported - debug target</h3>
|
||||
|
||||
<ul>
|
||||
<li>iOS 3.1.3 or earlier
|
||||
<li>webOS 1.45 or earlier
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
198
node_modules/weinre/web/doc/Installing.html
generated
vendored
Normal file
@ -0,0 +1,198 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Installing</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Installing</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p><span class="weinre">weinre</span> is implemented as a
|
||||
<a href="http://nodejs.org/">node.js</a> application, and so you'll
|
||||
need to <a href="http://nodejs.org/download/">download and install
|
||||
a node runtime</a> to run <span class="weinre">weinre</span>.
|
||||
|
||||
<p>To install <span class="weinre">weinre</span>, use <tt>npm</tt>,
|
||||
or download a binary package. <span class="weinre">weinre</span> is not
|
||||
sensitive to the directory it's installed in, and does not
|
||||
write to any files.
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>npm installation</h2>
|
||||
|
||||
<p><span class="weinre">weinre</span> can be installed as an
|
||||
<a href="http://npmjs.org/doc/README.html">npm package</a>. The
|
||||
<tt>*-bin.tar.gz</tt> urls/files for binary packages
|
||||
can be used as a target of the
|
||||
<a href="http://npmjs.org/doc/install.html"><tt>npm install</tt></a>
|
||||
command.
|
||||
|
||||
<p>It's likely you will want to install <span class="weinre">weinre</span>
|
||||
globally instead of locally (in the <tt>npm</tt> sense), which means you
|
||||
will typically want to use the <tt>npm -g</tt> option to install. For
|
||||
*ix and Mac, this also means prefixing your command with sudo. For Windows,
|
||||
AFAIK, you don't need sudo or any equivalent.
|
||||
|
||||
<p>Here's an example of installing from a binary package via URL:
|
||||
|
||||
<pre>
|
||||
sudo npm -g install http://example.com/path/to/apache-cordova-weinre-X.Y.Z-bin.tar.gz
|
||||
</pre>
|
||||
|
||||
<p><span class="weinre">weinre</span> is also deployed on
|
||||
<a href="https://npmjs.org/package/weinre">https://npmjs.org/package/weinre</a>
|
||||
so that you can install it via:
|
||||
|
||||
<pre>
|
||||
sudo npm -g install weinre
|
||||
</pre>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>Binary Packages</h2>
|
||||
|
||||
<!--
|
||||
<p>The recent source and binary release archives should be available at:
|
||||
|
||||
<ul>
|
||||
<li><a href="http://www.apache.org/dyn/closer.cgi/incubator/cordova">http://apache.org/dist/incubator/cordova/</a>
|
||||
<br><b><i>(at the time of this writing, that link does not actually resolve because
|
||||
there are no official releases)</i></b>
|
||||
</ul>
|
||||
|
||||
<p>All of the source and binary release archives should be available at:
|
||||
|
||||
<ul>
|
||||
<li><a href="http://archive.apache.org/dist/incubator/cordova/">http://archive.apache.org/dist/incubator/cordova/</a>
|
||||
<br><b><i>(at the time of this writing, that link does not actually resolve because
|
||||
there are no official releases)</i></b>
|
||||
</ul>
|
||||
-->
|
||||
|
||||
<p>Unofficial binary packages for your convenience:
|
||||
|
||||
<ul>
|
||||
<li><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a>
|
||||
</ul>
|
||||
|
||||
<p>The binary packages available are:
|
||||
|
||||
<ul>
|
||||
<li><tt>apache-cordova-weinre-{version}-bin.tar.gz</tt>
|
||||
<li><tt>apache-cordova-weinre-{version}-bin.zip</tt>
|
||||
<li><tt>apache-cordova-weinre-{version}-doc.tar.gz</tt>
|
||||
<li><tt>apache-cordova-weinre-{version}-doc.zip</tt>
|
||||
<li><tt>apache-cordova-weinre-{version}-src.tar.gz</tt>
|
||||
<li><tt>apache-cordova-weinre-{version}-src.zip</tt>
|
||||
</ul>
|
||||
|
||||
<p>The difference between the <tt>.tar.gz</tt> and <tt>.zip</tt>
|
||||
archives is the archive format only. When expanded, both archives
|
||||
produce the same files.
|
||||
|
||||
<p>The <tt>doc</tt> archives contain the stand-alone HTML documentation
|
||||
<p>The <tt>src</tt> archives contain the ready-to-rebuild source
|
||||
<p>The <tt>bin</tt> archives contain the ready-to-run binaries
|
||||
|
||||
<p>If the <tt>{version}</tt> contains a moniker like <tt>pre</tt>, this
|
||||
is indicative of an unofficial, non-final binary package for your convenience,
|
||||
as opposed to an official release.
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
116
node_modules/weinre/web/doc/License.html
generated
vendored
Normal file
@ -0,0 +1,116 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - License</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - License</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p>Source specific to <span class="weinre">weinre</span> is all licensed under the
|
||||
<a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
|
||||
|
||||
<p><span class="weinre">weinre</span> also makes use of third party code;
|
||||
the licensing details for those is available in the
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git;a=blob;f=LICENSE;hb=HEAD">LICENSE</a>
|
||||
file in the top-most directory of the source distribution.
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
196
node_modules/weinre/web/doc/MultiUser.html
generated
vendored
Normal file
@ -0,0 +1,196 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Muli-User</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Muli-User</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p><span class="weinre">weinre</span> was originally designed so that each user
|
||||
that wanted to use <span class="weinre">weinre</span> would run their own
|
||||
<span class="weinre">weinre</span> server. The system has since been enhanced
|
||||
to support muliple users using the same server.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Your debug id</h2>
|
||||
|
||||
<p>To use a multi-user server, you'll need to select an id for yourself. This
|
||||
id will be used in the client and target URLs of <span class="weinre">weinre</span>
|
||||
to scope your clients and targets from the clients and targets of other users.
|
||||
|
||||
<p>There is no password, just an id. There is no real security here.
|
||||
The id is a secret shared between your
|
||||
debug target and client, but it is sent in the clear when your target and
|
||||
client connect to the server. If someone else knows your <b>id</b>, they can
|
||||
connect to clients or targets you are running with that <b>id</b>.
|
||||
|
||||
<p>So don't give your <b>id</b> to anyone else that you don't want to share
|
||||
with.
|
||||
|
||||
<p>To keep your <b>id</b>'s familar but non-guessable, you might use a string
|
||||
consisting of your typical userid, followed by a dash, followed by another
|
||||
string not likely to be guessed by other people.
|
||||
|
||||
<p>If you are paranoid, you can change your <b>id</b> every time you start
|
||||
a debug session, of course.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Using your id with the client</h2>
|
||||
|
||||
<p>Typically when start a <span class="weinre">weinre</span> client session
|
||||
by visiting a URL like
|
||||
|
||||
<pre>
|
||||
http://some.server.xyz/client/
|
||||
</pre>
|
||||
|
||||
<p>To start
|
||||
a client with a particular id, append the hash character (<code>#</code>) and
|
||||
the id you want to use the URL. For instance, to connect with the id
|
||||
<code>itsReallyMe</code>, launch the client with the URL
|
||||
|
||||
<pre>
|
||||
http://some.server.xyz/client/#itsReallyMe
|
||||
</pre>
|
||||
|
||||
<p>The id which is used will be displayed
|
||||
in the connected clients list for each connected client.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Using your id with the target</h2>
|
||||
|
||||
<p>As with the server, append the hash character (<code>#</code>) to the
|
||||
URL of the script being injected into your web page. If you had previously
|
||||
used a <script src> element of:
|
||||
|
||||
<pre>
|
||||
<script src="http://some.server.xyz/target/target-script-min.js"></script>
|
||||
</pre>
|
||||
|
||||
<p>use this script element to connect with id <code>itsReallyMe</code>
|
||||
|
||||
<pre>
|
||||
<script src="http://some.server.xyz/target/target-script-min.js#itsReallyMe"></script>
|
||||
</pre>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Notes</h2>
|
||||
|
||||
<ul class="spaced">
|
||||
|
||||
<li>The <span class="weinre">weinre</span> server always runs in multi-user
|
||||
mode. If you don't otherwise specify an <b>id</b>, the value of
|
||||
<code>anonymous</code> will be used for the <b>id</b>.
|
||||
|
||||
<li>The <b>id</b> is passed in the HTTP body of a POST request during the
|
||||
initial connection of the target and client to the server, and is not sent
|
||||
thereafter. Thus, it should remain out of view in server logs and the like,
|
||||
though it will be visible for anyone who has access to the contents of
|
||||
HTTP request bodies.
|
||||
|
||||
<li>There is no programmatic interface in <span class="weinre">weinre</span>
|
||||
to list <b>id</b>'s in current use, for security reasons. From the Remote panel
|
||||
of weinre, each connected client and target have their channel and id's listed,
|
||||
if you can't remember what id you used with the client.
|
||||
|
||||
</ul>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
384
node_modules/weinre/web/doc/Running.html
generated
vendored
Normal file
@ -0,0 +1,384 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Running</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Running</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p>This page describes how to use <span class="weinre">weinre</span> to debug
|
||||
your own web pages on a remote device.
|
||||
|
||||
<p>First, some background.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Terminology</h2>
|
||||
|
||||
<p>When using <span class="weinre">weinre</span>, there are three programs interacting with
|
||||
each other.
|
||||
|
||||
<dl class="spaced">
|
||||
|
||||
<dt>Debug Server
|
||||
<dd>This is the HTTP server that you run from the <tt>weinre-node</tt> distribution.
|
||||
It's the HTTP server that's used by the
|
||||
<b>Debug Client</b> and <b>Debug Target</b>.
|
||||
|
||||
<dt>Debug Client
|
||||
<dd>This is the Web Inspector user interface; the web page which
|
||||
displays the Elements and Console panels, for instance.
|
||||
|
||||
<dt>Debug Target
|
||||
<dd>This is your web page that you want to debug. This
|
||||
name (Debug Target) is also used to refer to the machine
|
||||
running the browser displaying the web page. Since a design
|
||||
point of <span class="weinre">weinre</span> is to allow
|
||||
debugging applications on mobile devices, the debug
|
||||
target, when speaking of the machine, is your mobile
|
||||
device.
|
||||
|
||||
</dl>
|
||||
|
||||
<p>Both the <b>Debug Client</b> and the <b>Debug Target</b> communicate to
|
||||
the <b>Debug Server</b> via HTTP using <tt>XMLHttpRequest</tt> (XHR).
|
||||
|
||||
<p>Typically, you run both the <b>Debug Client</b> and the <b>Debug Server</b>
|
||||
on your desktop/laptop, and the <b>Debug Target</b> on your mobile device.
|
||||
|
||||
<p>The <b>Debug Target</b> is the squirrelliest bit. You
|
||||
will need to arrange to inject some JavaScript code, provided
|
||||
by the <b>Debug Server</b>, into your web page, in order for it
|
||||
to function as a <b>Debug Target</b>.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Running the debug server using an <tt>npm</tt> installation</h2>
|
||||
|
||||
<p>To run <span class="weinre">weinre</span> from an <tt>npm</tt>
|
||||
installation, assuming you've installed it globally (in the <tt>npm</tt>
|
||||
sense), execute the following command:
|
||||
|
||||
<pre>
|
||||
weinre [options]
|
||||
</pre>
|
||||
|
||||
<p>The server will run until you kill it. Control-C will do the job.
|
||||
|
||||
<p>Options available are:
|
||||
|
||||
<ul class="spaced no-bullet">
|
||||
|
||||
<li><tt>--help</tt> (or <tt>-?</tt> or <tt>-h</tt>)
|
||||
<div class="indent">
|
||||
<p>Display this help.
|
||||
</div>
|
||||
|
||||
<li><tt>--httpPort [portNumber]</tt>
|
||||
<div class="indent">
|
||||
<p>The port to run the HTTP server on.
|
||||
<p>Default: <tt>8080</tt>
|
||||
</div>
|
||||
|
||||
<li><tt>--boundHost [hostname | ip address | -all-]</tt>
|
||||
<div class="indent">
|
||||
<p>The ip address to bind the server to.
|
||||
<p>Default: <tt>localhost</tt>
|
||||
|
||||
<p>With the default of <tt>localhost</tt>, you won't be able to access
|
||||
the server from any machine other than the one the server is running on. You will
|
||||
need to bind to another hostname / ip address to make the server accessible to other
|
||||
machines. You can use the value <tt>-all-</tt> to indicate that you
|
||||
want to bind to all interfaces available on the current machine.
|
||||
|
||||
<p>Use <tt>ifconfig</tt> on Linux or the Mac, and <tt>ipconfig</tt>
|
||||
on Windows, to get the ip addresses available on your machine.
|
||||
</div>
|
||||
|
||||
<li><tt>--verbose [true | false]</tt>
|
||||
<div class="indent">
|
||||
<p>Causes jibberish to be written to stdout
|
||||
<p>Default: <tt>false</tt>
|
||||
</div>
|
||||
|
||||
<li><tt>--debug [true | false]</tt>
|
||||
<div class="indent">
|
||||
<p>Causes even more jibberish to be written to stdout
|
||||
<p>Default: <tt>false</tt>
|
||||
</div>
|
||||
|
||||
<li><tt>--readTimeout [seconds]</tt>
|
||||
<div class="indent">
|
||||
<p>The number of seconds the server will wait for a message
|
||||
to be available to send to the target or client.
|
||||
<p>Default: <tt>5</tt>
|
||||
|
||||
<p>Can probably be set larger, but then your browser may
|
||||
time out. Probably don't want to set it much lower than
|
||||
this as it will cause additional network traffic when
|
||||
no messages are being sent (it will cause more "empty"
|
||||
messages to be sent).
|
||||
</div>
|
||||
|
||||
<li><tt>--deathTimeout [seconds]</tt>
|
||||
<div class="indent">
|
||||
<p>The number of seconds to wait to hear back from a
|
||||
debug client or target before declaring them dead.
|
||||
<p>Default: <tt>3 * readTimeout</tt>
|
||||
|
||||
<p>Normally the default will be fine. However, if
|
||||
you're debugging <span class="weinre">weinre</span> itself, you may wish to set
|
||||
it much longer.
|
||||
</div>
|
||||
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>The <tt>~/.weinre/server.properties</tt> file</h2>
|
||||
|
||||
<p>You may also create a file named
|
||||
<tt>server.properties</tt> in the
|
||||
directory <tt>.weinre</tt> in your
|
||||
home directory (eg.
|
||||
<tt>~/.weinre/server.properties</tt>).
|
||||
Your home directory is the determined by the value of either the
|
||||
<tt>HOME</tt> or <tt>USERPROFILE</tt> environment variable.
|
||||
|
||||
<p>The keys should be
|
||||
the same as the name of the options above,
|
||||
with the same values.
|
||||
|
||||
<p>As an example, your <tt>~/.weinre/server.properties</tt>
|
||||
file might look like this:
|
||||
|
||||
<pre>
|
||||
boundHost: -all-
|
||||
httpPort: 8081
|
||||
reuseAddr: true
|
||||
readTimeout: 1
|
||||
deathTimeout: 5
|
||||
</pre>
|
||||
|
||||
<p>Command-line options override the options specified in the
|
||||
<tt>~/.weinre/server.properties</tt> file.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Running the debug server bound to something other than <tt>localhost</tt></h3>
|
||||
|
||||
<p>Since the web page you want to debug (the debug target) is probably running on
|
||||
a different machine (your mobile device) than the debug server (your desktop / laptop),
|
||||
you <b>can't</b> use the
|
||||
default <tt>localhost</tt> value for the <tt>--boundHost</tt>
|
||||
option. Instead, you will need to specify a host name / ip address
|
||||
with the <tt>--boundHost</tt> option. This host name / ip address
|
||||
must be accessible to the machine you want to use as the
|
||||
debug target.
|
||||
|
||||
<p>To get started, you can use the value <tt>-all-</tt> for the
|
||||
<tt>--boundHost</tt> option.
|
||||
|
||||
<p>Now you'll need to figure out what host name / ip address the
|
||||
debug target should use. If you've use the
|
||||
<tt>--boundHost -all-</tt> option, then bring up the debug client
|
||||
using the URL <tt>http://localhost:[portNumber]/client/</tt>
|
||||
from the same machine the debug server is running on. On that
|
||||
page, under <b>Server Properties</b>, is a list of bound hosts
|
||||
that the server believes it's available on.
|
||||
|
||||
<p>From the debug target device (eg, your mobile device),
|
||||
try accessing the server home page
|
||||
from all of those host names, using the URL
|
||||
<tt>http://[host name / ipaddress]:[portNumber]/</tt>.
|
||||
Once you find one
|
||||
that displays the server's home page correctly, remember
|
||||
that host name / ip address, we'll be using it in a minute.
|
||||
|
||||
<div class="note">
|
||||
<p>When you run the debug server with a bound host other than
|
||||
<tt>localhost</tt>, by definition other machines can now access
|
||||
your debug server. See the <a href="Security.html">Security page</a>
|
||||
for information on how to protect yourself.
|
||||
</div>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Instrumenting your web page to act as a debug target</h3>
|
||||
|
||||
<p>At this point you now have a URL to the debug server which
|
||||
will be accessible from the debug target. Let's say that URL
|
||||
(to the debug server's home page) is:
|
||||
<tt>http://a.b.c:8081</tt>.
|
||||
|
||||
<p>To make your web page debuggable with <span class="weinre">weinre</span>,
|
||||
add the following line to your web page:
|
||||
<pre>
|
||||
<script src="http://a.b.c:8081/target/target-script-min.js"></script>
|
||||
</pre>
|
||||
|
||||
<p>You can now open a debug client by browsing to
|
||||
<tt>http://a.b.c:8081/client</tt>
|
||||
(or probably
|
||||
<tt>http://localhost:8081/client</tt>
|
||||
as well) on your desktop/laptop,
|
||||
then reload your newly instrumented web page on your mobile device,
|
||||
and see the two connect in the Remote panel of the debug client.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Hardcoding host names / IP addresses in your web page?</h3>
|
||||
|
||||
<p>Yeah, gross.
|
||||
|
||||
<p>Besides being gross, there are a few practical problems with hardcoding the
|
||||
debug server address in your web page as well:
|
||||
|
||||
<ul class="spaced">
|
||||
|
||||
<li>Your html file is probably stored in an SCM, and you
|
||||
don't really want to be storing that address in the SCM.
|
||||
It won't work for other people using that html file,
|
||||
for instance.
|
||||
|
||||
<p>But you don't want to be keeping the
|
||||
<tt><script src=""></tt> line in your SCM either.
|
||||
You should look for a way, as part of your personal
|
||||
build process to add that line only for development
|
||||
builds, and presumably with a user-customizable URL.
|
||||
|
||||
<li>The URL the debug server runs on may be
|
||||
different depending on your location. At work, you may use
|
||||
one IP address and host name; at home, you likely have a different
|
||||
IP address and host name. You may not have a host name at all,
|
||||
just an IP address (which is fine - a host name isn't required,
|
||||
but usually makes things easier). You may be running on a
|
||||
dynamically assigned IP address, in which case your IP
|
||||
changes every time you log into your network.
|
||||
|
||||
<p>One way out of the dilemma is to use a dynamic
|
||||
DNS solution for the the machine you run the debug server on.
|
||||
Doing a web search on the following terms will provide you
|
||||
some links to such services:
|
||||
<a href="http://www.google.com/search?q=dynamic+dns+static+hostname">dynamic dns static hostname</a>
|
||||
|
||||
<p>If you use one of these dynamic DNS services, you
|
||||
can arrange to use the same host name for your debug server
|
||||
no matter what network you are connected to.
|
||||
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Using a bookmarklet</h2>
|
||||
|
||||
<p>Some platforms support 'bookmarkets', which allow you to inject
|
||||
arbitrary JavaScript code into any web page running in your
|
||||
browser. Mobile Safari is one of these browsers. It appears that
|
||||
the browser shipped with Android 2.2 and later also supports bookmarklets.
|
||||
|
||||
<p>Unfortunately, installing bookmarkets on mobile devices isn't usually trivial. The easiest
|
||||
course of action is to add a new random bookmark to your bookmarks,
|
||||
and then edit it by hand to change the label and URL. The URL
|
||||
you should use is available in both a 'pre' and 'textarea' section
|
||||
of the server's home page (eg, http://localhost:8081/). You should
|
||||
be able to select the text from one of these areas easily, to
|
||||
paste into the previously added bookmark.
|
||||
|
||||
<p>Once the bookmarklet is installed, you can debug any web page
|
||||
by visiting it, and selecting the bookmarklet from your bookmarks
|
||||
menu.
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
155
node_modules/weinre/web/doc/Security.html
generated
vendored
Normal file
@ -0,0 +1,155 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Security</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Security</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p>About security for <span class="weinre">weinre</span>: <b>there is none</b>.
|
||||
|
||||
<p>Obviously there should be some. The question is, what do we need to do?
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Background and potential exposures</h2>
|
||||
|
||||
<p>Currently <span class="weinre">weinre</span> uses plain old HTTP - not HTTPS - and provides
|
||||
no level of authentication for requests.
|
||||
|
||||
<p>The primary security exposure with <span class="weinre">weinre</span> is via
|
||||
the debug server.
|
||||
|
||||
<p>Currently, the server only reads files from the weinre-node distribution,
|
||||
and from the <tt>~/.weinre/</tt> directory (for property files).
|
||||
The only thing the server writes to is <tt>stdout</tt> and <tt>stderr</tt>.
|
||||
|
||||
<p>If you use the default <tt>--boundHost</tt> option value of
|
||||
<tt>localhost</tt>, then any software on the machine running the debug
|
||||
server can communicate with the debug server. This probably isn't a big
|
||||
deal, since presumably you control the software running on that machine.
|
||||
|
||||
<p>If you use a non-default <tt>--boundHost</tt> option value,
|
||||
then <b>any software on any machine that can access that specified
|
||||
host can communicate with the debug server</b>. This is a much bigger
|
||||
deal.
|
||||
|
||||
<p>The most obvious exposure with using <tt>--boundHost</tt> and
|
||||
a specific hostname / ip address, is that any debug client or
|
||||
debug target that can access that hostname / ip address can access
|
||||
the server. For example, a rogue debug client could connect to
|
||||
your debug target and fiddle about with it.
|
||||
|
||||
<p>Other exposures include leaving a debug target injection
|
||||
script line (ie, <tt><script src="[...]/target/target-script.js"></tt>)
|
||||
in your web page, and then that web page connects to a rogue debug
|
||||
server running at that address.
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Future Implementation Ideas</h2>
|
||||
|
||||
<ul class="spaced">
|
||||
|
||||
<li>Let's chat
|
||||
|
||||
</ul>
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
336
node_modules/weinre/web/doc/UserInterface.html
generated
vendored
Normal file
@ -0,0 +1,336 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - User Interface</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - User Interface</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p>This page describes the user interface provided by <span class="weinre">weinre</span>.
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the server home page</h2>
|
||||
|
||||
<p><img src="images/server-home.png">
|
||||
|
||||
<p>The server home page is accessed at the root URL of the server, in this case
|
||||
<tt>http://localhost:8081/</tt>.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>This link will launch the
|
||||
<span class="weinre">weinre</span> client page, which is the debugger itself.
|
||||
Clicking this link will take you to the Remote panel, described below.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>This is the URL of the script that you add to your
|
||||
web page to allow it to be debugged by the client.
|
||||
</table>
|
||||
|
||||
<p>Additional links shown in this image are for this documentation, and some demo
|
||||
pages.
|
||||
|
||||
<p>Further down on the page, not shown in the image, are:
|
||||
|
||||
<ul>
|
||||
<li>The text of the <tt><script src=></tt> element you can copy and paste into your
|
||||
web page.
|
||||
<li>The source for a bookmarklet, to inject the debug code into any web
|
||||
page displayed in your browser.
|
||||
<li>Version numbers of <span class="weinre">weinre</span> and it's components.
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Remote panel</h2>
|
||||
|
||||
<p><img src="images/panel-remote.png">
|
||||
|
||||
<p>The Remote panel is the initial panel of <span class="weinre">weinre</span>,
|
||||
and displays some status regarding the server.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The top portion of all of the
|
||||
<span class="weinre">weinre</span> panels shows the panel switcher. To switch
|
||||
to a different panel, click on the panel's button. The current panel is displayed with
|
||||
a highlight, as shown above for the Remote panel.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>The Targets section of this page lists targets that are currently connected
|
||||
to the server. A target is a web page that you are debugging.
|
||||
In this case, there is one target connected the server. Information
|
||||
about each target is displayed in the list, including host name / ip address, and
|
||||
the URL the target is displaying.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-c.png">
|
||||
<td>The Clients section of this page lists the clients that are currently connected
|
||||
to the server. A client is this user interface. Typically, there is just one - the client you are displaying
|
||||
at the time.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-d.png">
|
||||
<td>The Server Properties section of this page displays the values of various server
|
||||
properties currently in effect. Shown here are the hosts that are bound to the
|
||||
server - which host names / ip addresses that the server will respond to.
|
||||
</table>
|
||||
|
||||
<p>The colors of the entries in the Targets and Clients list indicates their
|
||||
status. Blue means the Target or Client is connected to the server, but not
|
||||
yet connected to a peer. Green means the Target or Client is connected to a
|
||||
peer, and you can start debugging. Red means the Target or Client has
|
||||
disconnected from the server, and will eventually fade away and be removed
|
||||
from the list.
|
||||
|
||||
<p>In case there are multiple targets connected, you can switch which one you
|
||||
are debugging by clicking on the item.
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Elements panel</h2>
|
||||
|
||||
<p><img src="images/panel-elements.png">
|
||||
|
||||
<p>The Elements panel displays your HTML DOM in a tree fashion, and properties
|
||||
associated with selected elements.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The elements themselves may be expanded/collapsed via the disclosure buttons.
|
||||
Elements and text can be edited by double-clicking the item to be edited.
|
||||
Elements can also be deleted by selecting the element and then pressing the
|
||||
delete button.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>The sidebar area displays information about the selected element. In this case,
|
||||
the Styles sidebar is expanded, showing relevant CSS rules. Some sidebars allow
|
||||
editing of the contents. The Styles sidebar in particular allows you to add, edit
|
||||
and remove properties and values by double clicking on them.
|
||||
</table>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Resources panel</h2>
|
||||
|
||||
<p><img src="images/panel-resources.png">
|
||||
|
||||
<p>The Resources panel shows WebSQL databases, and data stored in Local Storage
|
||||
and Session Storage.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The left hand side of the Resources panel is the navigator. Expanding
|
||||
the Databases entry will show all the Web SQL databases currently in use.
|
||||
Expanding a particular database will show all the tables in that database.
|
||||
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>The right hand side is the editor/viewer for whatever is selected in the
|
||||
navigator pane.
|
||||
When a database is selected, a prompt will appear in the editor/viewer area
|
||||
where you can enter SQL statements to be executed. The results are displayed
|
||||
inline. When a table is selected, all the rows from the table will be displayed.
|
||||
When a Local Storage or Session Storage entry is selected, all the relevant keys
|
||||
and values will be displayed. The keys and values in the Local Storage and
|
||||
Session Storage tables can be edited by double-clicking.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-c.png">
|
||||
<td>The reload button will refresh the data from the target.
|
||||
</table>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Network panel</h2>
|
||||
|
||||
<p><img src="images/panel-network.png">
|
||||
|
||||
<p>The Network panel shows you information regarding XHR requests that you've
|
||||
made.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>Each XHR will be shown in a separate row in the table. Clicking the
|
||||
path name of the XHR request will show additional information for that
|
||||
request in the right side of the panel.
|
||||
To display the table again, click the (x)
|
||||
button in the left top corner of the information pane (not shown in the
|
||||
image above).
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>The "dots and lines" button can be used to change the table layout to
|
||||
show less information in a more compact format.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-c.png">
|
||||
<td>The "not" button will clear the entries from the table.
|
||||
</table>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Timeline panel</h2>
|
||||
|
||||
<p><img src="images/panel-timeline.png">
|
||||
|
||||
<p>The Timeline panel is used to show events that are occurring in the target.
|
||||
Currently only two types of events are shown: timers/intervals, and user-specified
|
||||
events. Use <tt>console.markTimeline("A Label")</tt> to add a user-specified
|
||||
event to the timeline with the specified label.
|
||||
|
||||
<p>Note that timing events are not collected unless you enable the "record"
|
||||
button (see below).
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The left hand pane of the Timeline panel shows the events that have occurred.
|
||||
Hovering over an entry will show additional detail about the event.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-b.png">
|
||||
<td>The right hand pane of the Timeline panel shows the events as they occurred
|
||||
in time. Some events have other events associated with them, which will be shown
|
||||
when the disclosure triangle is expanded. The top-most time line of the right
|
||||
panel can have it's right and left hand edges moved to show a particular time
|
||||
range in more detail.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-c.png">
|
||||
<td>The "dots and lines" button can be used to show and hide events that last
|
||||
less than a fixed time (currently 15ms).
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-d.png">
|
||||
<td>The "record" button is used to start or stop event collection. When
|
||||
<span class="weinre">weinre</span> starts, the record button is off (black).
|
||||
When you click the record button to start collecting events, it will turn
|
||||
red.
|
||||
</table>
|
||||
|
||||
<p><table><tr><td><img src="images/circled-e.png">
|
||||
<td>The "not" button will clear the current timing entries.
|
||||
</table>
|
||||
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h2>the Console panel</h2>
|
||||
|
||||
<p><img src="images/panel-console.png">
|
||||
|
||||
<p>The Console panel is used to execute arbitrary JavaScript expressions/statements. It
|
||||
also shows the output from various <tt>console</tt> methods, like
|
||||
<tt>console.log()</tt>.
|
||||
|
||||
<p>In the example above, the JavaScript statements entered by the user are in
|
||||
blue, the output of the statements is just below it, and messages generated by
|
||||
<tt>console.log()</tt> are in black.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The "not" button will clear the console.
|
||||
</table>
|
||||
|
||||
<p><img src="images/panel-remote-console.png">
|
||||
|
||||
<p>The Console can also be embedded in every panel, by clicking the "console"
|
||||
button.
|
||||
|
||||
<table><tr><td><img src="images/circled-a.png">
|
||||
<td>The "console" button will embed the console in the bottom half of the
|
||||
other panels, or hide it if it's currently embedded in the other panels.
|
||||
</table>
|
||||
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
2
node_modules/weinre/web/doc/build-info.txt
generated
vendored
Normal file
@ -0,0 +1,2 @@
|
||||
weinre build 2.0.0-pre-I0Z7U9OV by Patrick Mueller
|
||||
git: 6c1543bc63e75850d29f0bd08a4b5bd1894d972f update for release 2.0.0-pre-HZO3BMNG
|
185
node_modules/weinre/web/doc/css/main.css
generated
vendored
Normal file
@ -0,0 +1,185 @@
|
||||
/*
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
*/
|
||||
|
||||
body {
|
||||
padding: 0em 2em;
|
||||
font-size: 120%
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.ribbon {
|
||||
position: absolute;
|
||||
top: 0;
|
||||
right: 0;
|
||||
border-left: thin solid #000;
|
||||
border-bottom: thin solid #000;
|
||||
-moz-border-radius-bottomleft: 0.5em;
|
||||
-webkit-border-bottom-left-radius: 0.5em;
|
||||
padding: 0.25em 0.5em;
|
||||
background-color: #FF8;
|
||||
font-style: italic;
|
||||
-webkit-box-shadow: 5px 5px 15px #888;
|
||||
-moz-box-shadow: 5px 5px 15px #888;
|
||||
box-shadow: 5px 5px 15px #888;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.no-decoration {
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.strike {
|
||||
text-decoration: line-through;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.weinre {
|
||||
color: #088;
|
||||
font-style: italic;
|
||||
font-weight: bold;
|
||||
font-family: Menlo, Monaco, Consolas, Lucida Console, dejavu sans mono, monospace;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.width-transition {
|
||||
-webkit-transition: width 0.3s linear;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.no-bullet {
|
||||
list-style-type: none;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.indent {
|
||||
margin-left: 3.0em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.no-bullet li {
|
||||
margin-top: 0.50em;
|
||||
margin-bottom: 0.50em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.spaced li {
|
||||
margin-top: 0.50em;
|
||||
margin-bottom: 0.50em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.spaced dt {
|
||||
margin-top: 0.50em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.spaced dd {
|
||||
margin-bottom: 0.50em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
dt {
|
||||
font-weight: bold;
|
||||
}
|
||||
|
||||
tt {
|
||||
white-space: pre;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.toc {
|
||||
font-style: italic;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.toc a {
|
||||
padding: 0.2em 0.5em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.page-title {
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.todo {
|
||||
background-color: #FAA;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.help {
|
||||
background-color: #FDD;
|
||||
font-weight: bold;
|
||||
font-size: 120%;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
.note {
|
||||
background-color: #FFA;
|
||||
font-weight: bold;
|
||||
font-size: 120%;
|
||||
margin: 0.25em 1.0em;
|
||||
padding: 0.00em 0.5em;
|
||||
border-width: 1;
|
||||
border-style: solid;
|
||||
border-radius: 0.5em;
|
||||
-moz-border-radius: 0.5em;
|
||||
-webkit-border-radius: 0.5em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
pre, xmp {
|
||||
border-width: 1;
|
||||
border-style: solid;
|
||||
overflow: auto;
|
||||
padding-top: 0.4em;
|
||||
padding-bottom: 0.4em;
|
||||
padding-left: 1.4em;
|
||||
padding-right: 1.4em;
|
||||
margin-left: 1.4em;
|
||||
margin-right: 1.4em;
|
||||
background: #FFFFDF;
|
||||
border-radius: 0.5em;
|
||||
-moz-border-radius: 0.5em;
|
||||
-webkit-border-radius: 0.5em;
|
||||
box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
-moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
-webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
h2 {
|
||||
padding: 0.25em 0.50em;
|
||||
background-color: #DDD;
|
||||
border-radius: 0.5em;
|
||||
-moz-border-radius: 0.5em;
|
||||
-webkit-border-radius: 0.5em;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------------*/
|
||||
kewl {
|
||||
box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
-moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
-webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
|
||||
border-radius: 0.5em;
|
||||
-moz-border-radius: 0.5em;
|
||||
-webkit-border-radius: 0.5em;
|
||||
}
|
BIN
node_modules/weinre/web/doc/images/circled-a.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.2 KiB |
BIN
node_modules/weinre/web/doc/images/circled-b.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.2 KiB |
BIN
node_modules/weinre/web/doc/images/circled-c.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.3 KiB |
BIN
node_modules/weinre/web/doc/images/circled-d.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.2 KiB |
BIN
node_modules/weinre/web/doc/images/circled-e.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.1 KiB |
BIN
node_modules/weinre/web/doc/images/circled-f.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.1 KiB |
BIN
node_modules/weinre/web/doc/images/circled-g.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.3 KiB |
BIN
node_modules/weinre/web/doc/images/circled-h.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.1 KiB |
BIN
node_modules/weinre/web/doc/images/circled-i.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.0 KiB |
BIN
node_modules/weinre/web/doc/images/circled-j.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.1 KiB |
BIN
node_modules/weinre/web/doc/images/panel-console.png
generated
vendored
Normal file
After Width: | Height: | Size: 123 KiB |
BIN
node_modules/weinre/web/doc/images/panel-elements.png
generated
vendored
Normal file
After Width: | Height: | Size: 165 KiB |
BIN
node_modules/weinre/web/doc/images/panel-network.png
generated
vendored
Normal file
After Width: | Height: | Size: 126 KiB |
BIN
node_modules/weinre/web/doc/images/panel-remote-console.png
generated
vendored
Normal file
After Width: | Height: | Size: 109 KiB |
BIN
node_modules/weinre/web/doc/images/panel-remote.png
generated
vendored
Normal file
After Width: | Height: | Size: 128 KiB |
BIN
node_modules/weinre/web/doc/images/panel-resources.png
generated
vendored
Normal file
After Width: | Height: | Size: 89 KiB |
BIN
node_modules/weinre/web/doc/images/panel-timeline.png
generated
vendored
Normal file
After Width: | Height: | Size: 115 KiB |
BIN
node_modules/weinre/web/doc/images/server-home.png
generated
vendored
Normal file
After Width: | Height: | Size: 109 KiB |
BIN
node_modules/weinre/web/doc/images/weinre-demo.jpg
generated
vendored
Normal file
After Width: | Height: | Size: 422 KiB |
BIN
node_modules/weinre/web/doc/images/weinre-icon-128x128.png
generated
vendored
Normal file
After Width: | Height: | Size: 5.6 KiB |
BIN
node_modules/weinre/web/doc/images/weinre-icon-512x512.png
generated
vendored
Normal file
After Width: | Height: | Size: 22 KiB |
BIN
node_modules/weinre/web/doc/images/weinre-icon-64x64.png
generated
vendored
Normal file
After Width: | Height: | Size: 2.5 KiB |
280
node_modules/weinre/web/doc/index.html
generated
vendored
Normal file
@ -0,0 +1,280 @@
|
||||
<!doctype html>
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<html>
|
||||
<head>
|
||||
<title>weinre - Home</title>
|
||||
<link rel="stylesheet" href="css/main.css" type="text/css">
|
||||
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div class="ribbon">clone weinre at
|
||||
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
|
||||
</div>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
<h1 class="page-title">weinre - Home</h1>
|
||||
|
||||
<div class="toc">
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
<p>
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<p><span class="weinre">weinre</span> is <b>WE</b>b <b>IN</b>spector <b>RE</b>mote.
|
||||
Pronounced like the word "winery". Or maybe like the word "weiner". Who knows,
|
||||
really.
|
||||
|
||||
<p><span class="weinre">weinre</span> is a debugger for web pages, like
|
||||
FireBug (for FireFox)
|
||||
and
|
||||
Web Inspector (for WebKit-based browsers), except it's designed
|
||||
to work <b>remotely</b>, and in particular, to <b>allow you debug web pages
|
||||
on a mobile device such as a phone</b>.
|
||||
|
||||
<p>Interesting places to visit:
|
||||
<table>
|
||||
|
||||
<tr><td>videos at YouTube:
|
||||
<td><a href="http://www.youtube.com/results?search_query=weinre">http://www.youtube.com/results?search_query=weinre</a>
|
||||
|
||||
<tr><td>this documentation:
|
||||
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
|
||||
|
||||
<tr><td>unofficial binary packages:
|
||||
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
|
||||
|
||||
<tr><td>issues:
|
||||
<td><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?jqlQuery=project=CB+and+component=weinre">https://issues.apache.org/jira/gobble-de-gook/...</a>
|
||||
|
||||
<tr><td>create a new issue:
|
||||
<td>
|
||||
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=1">bug</a>
|
||||
or
|
||||
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=2">new feature</a>
|
||||
|
||||
<tr><td>cloneable source at Apache:
|
||||
<td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
|
||||
|
||||
<tr><td>Apache repo cloned at GitHub:
|
||||
<td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
|
||||
|
||||
<tr><td>mailing lists at Apache:
|
||||
<td><a href="http://mail-archives.apache.org/mod_mbox/cordova-dev/">http://mail-archives.apache.org/mod_mbox/cordova-dev/</a> (for weinre development)
|
||||
|
||||
<tr><td>discussion at Google Group:
|
||||
<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a> (for weinre usage)
|
||||
|
||||
</table>
|
||||
|
||||
<p>More information on <span class="weinre">weinre</span>'s big brothers, Web Inspector / Google Chrome
|
||||
Developer Tools, is available at
|
||||
<a href="http://code.google.com/chrome/devtools/docs/overview.html">Google's Chrome Dev Tools pages</a>
|
||||
and
|
||||
<a href="http://developer.apple.com/library/safari/#documentation/appleapplications/Conceptual/Safari_Developer_Guide/DebuggingYourWebsite/DebuggingYourWebsite.html">Apple's Web Inspector pages</a>.
|
||||
|
||||
<p>If you aren't familiar with FireBug or Web Inspector,
|
||||
<span class="weinre">weinre</span> isn't going to make too much sense to you.
|
||||
<span class="weinre">weinre</span> reuses the user interface code from the
|
||||
<a href="http://trac.webkit.org/wiki/WebInspector">Web Inspector project at WebKit</a>,
|
||||
so if you've used Safari's Web Inspector or Chrome's Developer Tools,
|
||||
<span class="weinre">weinre</span> will be very familiar. If you're not
|
||||
familiar with Web Inspector, the links above to Google's and Apple's documentation
|
||||
will be useful.
|
||||
|
||||
<p>Here's an example session using <span class="weinre">weinre</span>:
|
||||
|
||||
<p><img src="images/weinre-demo.jpg">
|
||||
|
||||
<p>Two screen captures are shown above. On the left is the
|
||||
<span class="weinre">weinre</span> <b>client</b> application, displaying debug
|
||||
information.
|
||||
On the right is the <b>target</b> web page, running in Mobile Safari in the iOS Simulator.
|
||||
|
||||
<p>In normal usage, you will be running the <b>client</b> application in a browser
|
||||
on your desktop/laptop, and running a <b>target</b> web page on your mobile device.
|
||||
|
||||
<p>In the session above, the debugger is display the Elements panel, with the
|
||||
embedded console expanded in the bottom third of the window. In the console
|
||||
area, we've entered two statements:
|
||||
|
||||
<pre>
|
||||
document.body.style.backgroundColor
|
||||
document.body.style.backgroundColor = "pink"
|
||||
</pre>
|
||||
|
||||
<p>The result of running the first statement shows the value of the body's background style is not set.
|
||||
The second statement sets the body's background to pink. That horrifying pink
|
||||
background is then rendered in the <b>target</b>'s window.
|
||||
|
||||
<p>In addition, an <tt>h1</tt> element is selected in the upper third of the
|
||||
Elements panel, which causes the side panels on the right to be filled in with
|
||||
relevant information. In this case, the matched CSS rules for that <tt>h1</tt>
|
||||
element are being shown.
|
||||
|
||||
<p>If you are familiar with WebKit's Web Inspector,
|
||||
a partial list of differences between it and <span class="weinre">weinre</span>
|
||||
are listed below:
|
||||
|
||||
<ul class="spaced">
|
||||
|
||||
<li><span class="weinre">weinre</span> does not make use of any 'native' code
|
||||
in the browser, it's all plain old boring JavaScript.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
|
||||
it's functionality is limited. For instance, source level debug of JavaScript
|
||||
is not <span class="strike">possible</span>
|
||||
<a href="http://lexandera.com/aardwolf/">easy</a>.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
|
||||
the debug target code will run on browsers
|
||||
without specialized debug support. For instance, a browser running on your phone.
|
||||
|
||||
<li><span class="weinre">weinre</span> supports 'remote' interaction,
|
||||
so you can run the debugger user interface on one
|
||||
machine and can debug a web page running
|
||||
on another machine. For instance, debug a web page displayed on your phone from your
|
||||
laptop.
|
||||
|
||||
<li>Because <span class="weinre">weinre</span> supports 'remote' interaction,
|
||||
multiple debug clients can be debugging the same debug target at the same time.
|
||||
|
||||
<li>One thing <b>not</b> different from Web Inspector is that the debug client
|
||||
user interface only runs on WebKit-based browsers.
|
||||
|
||||
</ul>
|
||||
|
||||
<!-- ======================================================== -->
|
||||
<h2>Supported Libraries and Platforms</h2>
|
||||
|
||||
<p>Generally version numbers listed here are the earliest
|
||||
versions of the relevant thing that have been tested.
|
||||
Later versions of those things are also hopefully supported,
|
||||
but let us know.
|
||||
|
||||
<h3>Libraries not supported</h3>
|
||||
|
||||
<ul>
|
||||
<li>versions of Prototype.js before version 1.7 are not supported,
|
||||
as they do not support the <tt>JSON.stringify()</tt> API correctly. You
|
||||
will get an <tt>alert()</tt> in the web page you are debugging if you
|
||||
attempt to debug it with <span class="weinre">weinre</span> and you are using an unsupported
|
||||
version of Prototype.js.
|
||||
</ul>
|
||||
|
||||
<h3>Platforms supported - debug server</h3>
|
||||
<p>Any platform that supports <a href="http://nodejs.org/">node.js</a>.
|
||||
|
||||
<h3>Platforms supported - debug client</h3>
|
||||
<p>The browser where the debugger user interface runs.
|
||||
|
||||
<ul>
|
||||
<li>Google Chrome
|
||||
<li>Apple Safari
|
||||
<li>Other recent-ish WebKit-based browsers
|
||||
</ul>
|
||||
|
||||
<h3>Platforms supported - debug target</h3>
|
||||
<p>The browser with the page you are debugging.
|
||||
|
||||
<ul>
|
||||
<li>Android Browser application
|
||||
<li>iOS Mobile Safari application
|
||||
<li>PhoneGap/Cordova
|
||||
<li>other
|
||||
</ul>
|
||||
|
||||
<h3>Platforms not supported - debug target</h3>
|
||||
|
||||
<ul>
|
||||
<li>iOS 3.1.3 or earlier
|
||||
<li>webOS 1.45 or earlier
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<!--
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
-->
|
||||
|
||||
<div class="toc">
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
<p>
|
||||
<a href="Home.html">Home</a>
|
||||
- <a href="UserInterface.html">User Interface</a>
|
||||
- <a href="Installing.html">Installing</a>
|
||||
- <a href="Running.html">Running</a>
|
||||
- <a href="MultiUser.html">Multi-User</a>
|
||||
- <a href="Security.html">Security</a>
|
||||
- <a href="Building.html">Building</a>
|
||||
- <a href="ChangeLog.html">ChangeLog</a>
|
||||
- <a href="License.html">License</a>
|
||||
|
||||
<br><img src="images/weinre-icon-128x128.png">
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
91
node_modules/weinre/web/doc/scripts/main.js
generated
vendored
Normal file
@ -0,0 +1,91 @@
|
||||
/*
|
||||
* Licensed to the Apache Software Foundation (ASF) under one
|
||||
* or more contributor license agreements. See the NOTICE file
|
||||
* distributed with this work for additional information
|
||||
* regarding copyright ownership. The ASF licenses this file
|
||||
* to you under the Apache License, Version 2.0 (the
|
||||
* "License"); you may not use this file except in compliance
|
||||
* with the License. You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing,
|
||||
* software distributed under the License is distributed on an
|
||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
* KIND, either express or implied. See the License for the
|
||||
* specific language governing permissions and limitations
|
||||
* under the License.
|
||||
*/
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function main() {
|
||||
// window.addEventListener("load", addClickToExpandImageHandlers, false);
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function addClickToExpandImageHandlers() {
|
||||
var elements = document.getElementsByTagName("img")
|
||||
for (var i=0; i<elements.length; i++) {
|
||||
var element = elements[i]
|
||||
if (!hasClass(element, "expand-on-click")) continue
|
||||
|
||||
addClass(element, "width-transition")
|
||||
element._original_width_ = element.width
|
||||
element._contracted_ = true
|
||||
element.width = element.width / 2
|
||||
|
||||
element.addEventListener("click", clickToExpand, false)
|
||||
}
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function clickToExpand(event) {
|
||||
var element = this
|
||||
|
||||
if (element._contracted_) {
|
||||
element.width = element._original_width_
|
||||
}
|
||||
else {
|
||||
element.width = element._original_width_ / 2
|
||||
}
|
||||
|
||||
element._contracted_ = ! element._contracted_
|
||||
|
||||
// if (hasClass(element, "contracted")) {
|
||||
// removeClass(element, "contracted")
|
||||
// }
|
||||
//
|
||||
// else {
|
||||
// addClass(element, "contracted")
|
||||
// }
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function hasClass(element, className) {
|
||||
var classNames = element.className.split(/\s+/)
|
||||
for (var i=0; i<classNames.length; i++) {
|
||||
if (className == classNames[i]) return true
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function addClass(element, className) {
|
||||
if (hasClass(element, className)) return
|
||||
|
||||
element.className += " " + className
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
function removeClass(element, className) {
|
||||
var classNames = element.className.split(/\s+/)
|
||||
for (var i=0; i<classNames.length; i++) {
|
||||
if (className == classNames[i]) {
|
||||
classNames[i] = ""
|
||||
}
|
||||
}
|
||||
element.className = classNames.join(" ")
|
||||
}
|
||||
|
||||
//-----------------------------------------------------------------------------
|
||||
main()
|