Add androidhelper APIs documentation (some parts)

Author: riverfor

docs/_sources/en/guide_androidhelpers.txt

@@ -1,9 +1,59 @@
-How to call QPython script in your application?
+QPython Open API 
 =====================================================
-You could call QPython to run some script or python code in your app
+QPython has an open activity which allow you run qpython from outside.
+
+The MPyAPI's definition seems like the following:
 
 ::
 
+        <activity 
+            android:name="org.qpython.qpylib.MPyApi"
+            android:label="@string/qpy_run_with_share"
+            android:screenOrientation="user"
+            android:configChanges="orientation|keyboardHidden"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="org.qpython.qpylib.action.MPyApi" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="http" />
+                <data android:scheme="https" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.SEND"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <data android:mimeType="text/plain"/>
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.SEND"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <data android:mimeType="image/*"/>
+            </intent-filter>
+        </activity>
+
+
+**So, with it's help, you could:**
+
+Share some content to QPython's scripts
+---------------------------------------------
+You could choose some content in some app, and share to qpython's script, then you could handle the content with the **sys.argv[2]**
+
+`Watch the demo video on YouTube <https://www.youtube.com/watch?v=2Y50Yir8TWg>`_
+
+
+Run QPython's script from your own application
+------------------------------------------------------
+
+You can call QPython to run some script or python code in your application by call this activity, like the following sample:
+
+::
+
+    // code sample shows how to call qpython API
     String extPlgPlusName = "org.qpython.qpy";          // QPython package name
     Intent intent = new Intent();
     intent.setClassName(extPlgPlusName, "org.qpython.qpylib.MPyApi");
@@ -12,33 +62,26 @@ You could call QPython to run some script or python code in your app
     Bundle mBundle = new Bundle();
     mBundle.putString("app", "myappid");
     mBundle.putString("act", "onPyApi");
-    mBundle.putString("flag", "onQPyExec");             // any String flag you may use in your context
-    mBundle.putString("param", "");                     // param String param you may use in your context
+    mBundle.putString("flag", "onQPyExec"); // any String flag you may use in your context
+    mBundle.putString("param", "");         // param String param you may use in your context
 
     /*
-    * The String Python code, you can put your py file in res or raw or intenet, so that you can get it the same way, which can make it scalable
+    * The Python code we will run
     */
-    String code = "#qpy:console\n" +
-                "try:\n" +
-                "    import androidhelper\n" +
-                "\n" +
-                "    droid = androidhelper.Android()\n" +
-                "    line = droid.dialogGetInput()\n" +
-                "    s = 'Hello %s' % line.result\n" +
-                "    droid.makeToast(s)\n" +
-                "except:\n" +
-                "    print(\"Hello, Please update to newest QPython version from (http://play.qpython.com/qrcode-python.html) to use this feature\")\n");
-
+    String code = "import androidhelper\n" +
+                "droid = androidhelper.Android()\n" +
+                "line = droid.dialogGetInput()\n" +
+                "s = 'Hello %s' % line.result\n" +
+                "droid.makeToast(s)\n"
 
     mBundle.putString("pycode", code);
     intent.putExtras(mBundle);
-
     startActivityForResult(intent, SCRIPT_EXEC_PY);
-
     ...
 
 
-    // Deal with the result callback by qpython
+
+    // And you can handle the qpython callabck result in onActivityResult
     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
         if (requestCode == SCRIPT_EXEC_PY) {
@@ -56,16 +99,33 @@ You could call QPython to run some script or python code in your app
     }
 
 
+`Checkout the full project from github <https://github.com/qpython-android/app-call-qpython-api>`_
+
+And there is `a production application - QPython Plugin for Tasker <https://play.google.com/store/apps/details?id=com.qpython.tasker2>`_
 
-Sample of running QPython script in other application
--------------------------------------------------------
-* `You can see this sample project in github <https://github.com/qpython-android/app-call-qpython-api>`_
+QPython Online Service
+=====================================================
 
-* `Another Application which have published in google play - QPython Plugin for Tasker <https://play.google.com/store/apps/details?id=com.qpython.tasker2>`_
+Now the QPython online service only open for QPython, not QPython3.
 
-.. image:: ../_static/taskerplugin-for-qpython.png
 
-How to build an independt APK from QPython scripts?
-=====================================================
-http://qpy.io
+QPypi
+---------------------------------------------------------
+Can I install some packages which required pre-compiled ?
+Sure, you could install some pre-compiled packages from QPypi, you could find it through "Libraries" on dashboard.
+
+
+.. image:: ../_static/guide_extend_pic2.png
+
+If you couldn't found the package here, you could send email to river@qpython.org .
+
+QPY.IO
+---------------------------------------------------
+Can I build an independent APK from QPython script?
+
+Sure you can. now the service is **in BETA**, it's a challenging thing. We will publish it as a online service, for we want to let the development process is simple, you don't need to own the development environment set up when you want to build a application.
+
+
+.. image:: ../_static/guide_extend_pic1.png
 
+If you want to try it out or have some business proposal, please contact with us by sending email to river@qpython.org .

docs/_sources/en/guide_extend.txt

@@ -22,7 +22,7 @@ QEditor is the QPython's built-in editor, which supports Python / HTML syntax hi
 You could run the QPython script directly when you develop from QEditor, so when you are moving it's the most convient way for QPython develop.
 
 
-Develop from your PC/Laptop's browser
+Develop from browser
 --------------------------------------
 QPython has a built-in script which is **qedit4web.py**, you could see it when you click the start button and choose  "Run local script".
 After run it, you could see the result.
@@ -44,3 +44,6 @@ Then, you could access the url from your PC/Laptop's browser for developing, jus
 With it's help, you could write from browser and run from your android phone. It is very convenient.
 
 
+Develop from your computer
+--------------------------
+Besides the above ways, you could develop the script with your way, then upload to your phone and run with QPython also.

docs/_sources/en/guide_ide.txt

@@ -2,8 +2,10 @@ QPython built-in Libraries
 ==========================
 QPython is using the Python 2.7.2 and it support most Python stardard libraries. And you could see their documentation through Python documentation.
 
-QPython dynload libraries (python built-in .so libraries)
+QPython dynload libraries 
 --------------------------------------------------------------
+Just like Python, QPython contains python built-in .so libraries.
+
 Usually, you don't need to  import them manually, they were used in stardard libraries, and could be imported automatically.
 
 * _codecs_cn.so

docs/_sources/en/guide_libraries.txt

@@ -1,6 +1,8 @@
-What can QPython do?
+QPython's main features
 ====================================
 
+**With QPython, you could build android applications with android application and script language now.**
+
 
 Why should I choose QPython
 ------------------------

docs/_sources/en/guide_program.txt

@@ -37,13 +37,13 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="#programming-guide">Programming Guide</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="guide_program.html">What can QPython do?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_program.html">QPython&#8217;s main features</a></li>
 <li class="toctree-l2"><a class="reference internal" href="guide_ide.html">Use the best way for developing</a></li>
 <li class="toctree-l2"><a class="reference internal" href="guide_libraries.html">QPython built-in Libraries</a></li>
 <li class="toctree-l2"><a class="reference internal" href="guide_libraries.html#python-3rd-libraries">Python 3rd Libraries</a></li>
 <li class="toctree-l2"><a class="reference internal" href="guide_libraries.html#androidhelper-apis">Androidhelper APIs</a></li>
-<li class="toctree-l2"><a class="reference internal" href="guide_extend.html">How to call QPython script in your application?</a></li>
-<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#how-to-build-an-independt-apk-from-qpython-scripts">How to build an independt APK from QPython scripts?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html">QPython Open API</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#qpython-online-service">QPython Online Service</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="#qpython-hackers-guide">QPython Hackers&#8217; Guide</a></li>
@@ -104,18 +104,19 @@ <h1>Programming Guide<a class="headerlink" href="#programming-guide" title="Perm
 <p>If you you want to know more about how to program through qpython, just follow these steps:</p>
 <div class="toctree-wrapper compound">
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="guide_program.html">What can QPython do?</a><ul>
+<li class="toctree-l1"><a class="reference internal" href="guide_program.html">QPython&#8217;s main features</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="guide_program.html#why-should-i-choose-qpython">Why should I choose QPython</a></li>
-<li class="toctree-l2"><a class="reference internal" href="guide_program.html#qpython-s-main-features">QPython&#8217;s main features</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_program.html#id1">QPython&#8217;s main features</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="guide_ide.html">Use the best way for developing</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="guide_ide.html#develop-from-qeditor">Develop from QEditor</a></li>
-<li class="toctree-l2"><a class="reference internal" href="guide_ide.html#develop-from-your-pc-laptop-s-browser">Develop from your PC/Laptop&#8217;s browser</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_ide.html#develop-from-browser">Develop from browser</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_ide.html#develop-from-your-computer">Develop from your computer</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="guide_libraries.html">QPython built-in Libraries</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="guide_libraries.html#qpython-dynload-libraries-python-built-in-so-libraries">QPython dynload libraries (python built-in .so libraries)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_libraries.html#qpython-dynload-libraries">QPython dynload libraries</a></li>
 <li class="toctree-l2"><a class="reference internal" href="guide_libraries.html#qpython-stardard-libraries">QPython stardard libraries</a></li>
 </ul>
 </li>
@@ -150,11 +151,16 @@ <h1>Programming Guide<a class="headerlink" href="#programming-guide" title="Perm
 <li class="toctree-l2"><a class="reference internal" href="guide_androidhelpers.html#uifacade">UiFacade</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="guide_extend.html">How to call QPython script in your application?</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#sample-of-running-qpython-script-in-other-application">Sample of running QPython script in other application</a></li>
+<li class="toctree-l1"><a class="reference internal" href="guide_extend.html">QPython Open API</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#share-some-content-to-qpython-s-scripts">Share some content to QPython&#8217;s scripts</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#run-qpython-s-script-from-your-own-application">Run QPython&#8217;s script from your own application</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="guide_extend.html#qpython-online-service">QPython Online Service</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#qpypi">QPypi</a></li>
+<li class="toctree-l2"><a class="reference internal" href="guide_extend.html#qpy-io">QPY.IO</a></li>
 </ul>
 </li>
-<li class="toctree-l1"><a class="reference internal" href="guide_extend.html#how-to-build-an-independt-apk-from-qpython-scripts">How to build an independt APK from QPython scripts?</a></li>
 </ul>
 </div>
 </div>