docs/en/guide_program.html · qpython-android/qpython.org

代码拉取完成,页面将自动刷新

扫描微信二维码支付

取消

支付完成

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

1 Star 0 Fork 0

qpython-android/qpython.org

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

文件

master

分支 (1)

管理

master

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

分支 1

标签 0

qpython.org

docs

guide_program.html

guide_program.html 20.49 KB

<!DOCTYPE html>
<html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>QPython’s main features &#8212; QPython 0.9 documentation</title>
<link rel="stylesheet" href="../static/qpython_theme.css" type="text/css" />
<link rel="stylesheet" href="../static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '0.9',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../static/jquery.js"></script>
<script type="text/javascript" src="../static/underscore.js"></script>
<script type="text/javascript" src="../static/doctools.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Use the best way for developing" href="guide_ide.html" />
<link rel="prev" title="Writing "Hello World"" href="guide_helloworld.html" />
<meta charset="UTF-8">
<link href="//cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
<script src="//cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
<meta name="viewport" content="width=device-width, initial-scale=1,maximum-scale=1, user-scalable=no">
</head>
<body>
<div class="header doc-header">
<div class="col-lg-offset-2 col-lg-8 col-md-offset-2 col-md-8 col-sm-offset-2 col-sm-8 index-header">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse"
data-target="#example-navbar-collapse">
切换导航



</button>
<a href="/index.html" class="logo"><img src="../static/img_logo.png"></a>
</div>
<ul class="header-title hidden-xs">
<li class="header-phone-selected">
<a href="/index.html">Home</a>
</li>
<li>
<a href="/document.html" class="header-selected">Guide</a>

</li>
<li>
<a href="//edu.qpython.org/">Course</a>
</li>
<li>
<a href="//www.aipy.org">AIPY</a>
</li>
<li>
<a target="_blank" href="//github.com/qpython-android/qpython">Github</a>
</li>
</ul>
<div class="search-box hidden-xs">
<form action="../search.html">
<input type="search" name="q" placeholder="keyword">
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
<button><img src="../static/ic_search.png"></button>
</form>
</div>
</div>
</div>
<div class="row doc-content">
<div class="content-main col-sm-offset-2 col-sm-8">
<div class="content-wrapper col-sm-4">
<div class="left-menu">
<div class="doc-title hidden-xs">QPython</div>
<div class="sidebar collapse navbar-collapse" id="example-navbar-collapse">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="guide.html">Getting started</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="guide.html#programming-guide">Programming Guide</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">QPython’s main features</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#why-should-i-choose-qpython">Why should I choose QPython</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id1">QPython’s main features</a></li>
</ul>
</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">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="guide.html#developer-guide">Developer Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide.html#contributor-guide">Contributor Guide</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="faq.html">FAQ</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../zhindex.html">中文用户向导</a></li>
</ul>
<div class="search-phone visible-xs">
<form action="../search.html">
<input type="search" name="q" placeholder="keyword">
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
<button><img src="../static/ic_search.png"></button>
</form>
</div>
</div>
</div>
</div>
<div class="content col-sm-8">
<div class="document">
<ul class="crumbs">
<li><a href="../document.html">Guide</a> &raquo;</li>
<li><a href="guide.html">Getting started</a> &raquo;</li>
<li>QPython’s main features</li>
</ul>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="qpython-s-main-features">
<h1>QPython’s main features<a class="headerlink" href="#qpython-s-main-features" title="Permalink to this headline">¶</a></h1>
With QPython, you could build android applications with android application and script language now.
<div class="section" id="why-should-i-choose-qpython">
<h2>Why should I choose QPython<a class="headerlink" href="#why-should-i-choose-qpython" title="Permalink to this headline">¶</a></h2>
The smartphone is becomming people’s essential information &amp; technical assitant, so an flexiable script engine could help people complete most jobs efficiently without complex development.
QPython offer an amazing developing experience, with it’s help, you could implement the program easily without complex installing IDE, compiling, package progress etc.
</div>
<div class="section" id="id1">
<h2>QPython’s main features<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
You can do most jobs through QPython just like the way that Python does on PC/Laptop.
Libraries
<ul class="simple">
<li>QPython supports most stardard Python libraries.</li>
<li>QPython supports many 3rd Python libraries which implemented with pure Python code.</li>
<li>QPython supports some Python libraries mixed with C/C++ code which pre-compiled by QPython develop team.</li>
<li>QPython allows you put on the libraries by yourself.</li>
</ul>
Besides these, QPython offers some extra features which Python doesn’t offer, Like:
<ul class="simple">
<li>Android APIs Access(Like SMS, GPS, NFC, BLUETOOTH etc)</li>
</ul>
Why QPython require so many permissions?
QPython need these permissions to access Android’s API.
Runtime modes
QPython supports several runtime modes for android.
Console mode
It’s the default runtime mode in QPython, it’s very common in PC/laptop.
Kivy mode
QPython supports <a class="reference external" href="http://kivy.org">Kivy</a> as the GUI programming solution.
Kivy is an open source Python library for rapid development of applications that make use of innovative user interfaces, such as multi-touch apps.
Your device should support opengl2.0 for supporting kivy mode.
By insert into the following header in your script, you can let your script run with kivy mode.
<div class="highlight-default"><div class="highlight"><pre>#qpy:kivy
</pre></div>
</div>
An kivy program in QPython sample
<div class="highlight-default"><div class="highlight"><pre>#qpy:kivy
from kivy.app import App
from kivy.uix.button import Button
class TestApp(App):
def build(self):
return Button(text=&#39;Hello World&#39;)
TestApp().run()
</pre></div>
</div>
If your library require the opengl driver, you shoule declare the kivy mode header in your script, like the jnius.
NOTE: QPython3 didn’t support kivy mode yet, we have plan to support it in the future
WebApp mode
We recommend you implement WebApp with QPython for it offer the easy to accomplish UI and Take advantage of Python’s fast programming strong point.
WebApp will start a webview in front, and run a python web service background.
You could use bottle*(QPython built-in library) to implement the web service, or you could install *django / flask framework also.
By insert into the following header in your script, you can let your script run with webapp mode.
<div class="highlight-default"><div class="highlight"><pre>#qpy:webapp:&lt;app title&gt;
#qpy:&lt;fullscreen or remove this line&gt;
#qpy://&lt;ip:port:path&gt;
</pre></div>
</div>
For example
<div class="highlight-default"><div class="highlight"><pre>#qpy:webapp:Hello QPython
#qpy://localhost:8080/hello
</pre></div>
</div>
The previous should start a webview which should load the http://localhost:8080/hello as the default page, and the webview will keep the titlebar which title is "Hello QPython", if you add the #qpy:fullscreen it will hide the titlebar.
<div class="highlight-default"><div class="highlight"><pre>#qpy:webapp:Hello Qpython
#qpy://127.0.0.1:8080/
&quot;&quot;&quot;
This is a sample for qpython webapp
&quot;&quot;&quot;
from bottle import Bottle, ServerAdapter
from bottle import run, debug, route, error, static_file, template
######### QPYTHON WEB SERVER ###############
class MyWSGIRefServer(ServerAdapter):
server = None
def run(self, handler):
from wsgiref.simple_server import make_server, WSGIRequestHandler
if self.quiet:
class QuietHandler(WSGIRequestHandler):
def log_request(*args, **kw): pass
self.options[&#39;handler_class&#39;] = QuietHandler
self.server = make_server(self.host, self.port, handler, **self.options)
self.server.serve_forever()
def stop(self):
#sys.stderr.close()
import threading
threading.Thread(target=self.server.shutdown).start()
#self.server.shutdown()
self.server.server_close() #&lt;--- alternative but causes bad fd exception
print &quot;# qpyhttpd stop&quot;
######### BUILT-IN ROUTERS ###############
@route(&#39;/__exit&#39;, method=[&#39;GET&#39;,&#39;HEAD&#39;])
def __exit():
global server
server.stop()
@route(&#39;/assets/&lt;filepath:path&gt;&#39;)
def serverstatic(filepath):
return static_file(filepath, root=&#39;/sdcard&#39;)
######### WEBAPP ROUTERS ###############
@route(&#39;/&#39;)
def home():
return template(&#39;&lt;h1&gt;Hello {{name}} !&lt;/h1&gt;&#39;+ \
&#39;&lt;a href=&quot;/assets/qpython/projects/WebApp Sample/main.py&quot;&gt;View source&lt;/a&gt;&#39;,name=&#39;QPython&#39;)
######### WEBAPP ROUTERS ###############
app = Bottle()
app.route(&#39;/&#39;, method=&#39;GET&#39;)(home)
app.route(&#39;/__exit&#39;, method=[&#39;GET&#39;,&#39;HEAD&#39;])(__exit)
app.route(&#39;/assets/&lt;filepath:path&gt;&#39;, method=&#39;GET&#39;)(serverstatic)
try:
server = MyWSGIRefServer(host=&quot;127.0.0.1&quot;, port=&quot;8080&quot;)
app.run(server=server,reloader=False)
except Exception,ex:
print &quot;Exception: %s&quot; % repr(ex)
</pre></div>
</div>
If you want the webapp could be close when you exit the webview, you have to define the &#64;route(‘/__exit’, method=[‘GET’,’HEAD’]) method , for the qpython will request the http://localhost:8080/__exit when you exit the webview. So you can release other resource in this function.
<img alt="QPython WebApp Sample" src="../images/guide_program_pic1.png" />
Running screenshot
In the other part of the code, you could implement a webserver whish serve on localhost:8080 and make the URL /hello implement as your webapp’s homepage.
Q mode
If you don’t want the QPython display some UI, pelase try to use the QScript mode, it could run a script background, just insert the following header into your script:
<div class="highlight-default"><div class="highlight"><pre>#qpy:qpyapp
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="fb-comments" data-href="http://qpython.org" data-numposts="10"></div>
</div>
</div>
<div class="col-sm-2"></div>
</div>
<footer id="footer">
<div class="col-sm-offset-2 col-sm-6 footer-div1">
<div class="footer-block-item">
Built with Sphinx using a theme provid by QPython.

&#169; Copyright 2017, QPython.

</div>
</div>
<div class="col-sm-2 footer-div2">
<a href="/index.html" class="pull-right"><img src="../static/img_logo.png"></a>
</div>
</footer>
<script type="text/javascript">
$('.fb-comments').attr('data-href', (window.location.href.split('#')[0]).split('?')[0])
(function(d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) return;
js = d.createElement(s); js.id = id;
js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.8&appId=1680815145503311";
fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));
$(function(){
if ($('#footer')[0].offsetTop < $(window).height()){
$('#footer').addClass('to-bottom')
}
})
</script>
</body>
</html>

一键复制编辑原始数据按行查看历史

River 提交于 2020年01月25日 12:13 +08:00 . Update style

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287

<!DOCTYPE html>
<html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>QPython’s main features &#8212; QPython 0.9 documentation</title>
<link rel="stylesheet" href="../static/qpython_theme.css" type="text/css" />
<link rel="stylesheet" href="../static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '0.9',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../static/jquery.js"></script>
<script type="text/javascript" src="../static/underscore.js"></script>
<script type="text/javascript" src="../static/doctools.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Use the best way for developing" href="guide_ide.html" />
<link rel="prev" title="Writing "Hello World"" href="guide_helloworld.html" />
<meta charset="UTF-8">
<link href="//cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
<script src="//cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
<meta name="viewport" content="width=device-width, initial-scale=1,maximum-scale=1, user-scalable=no">
</head>
<body>
<div class="header doc-header">
<div class="col-lg-offset-2 col-lg-8 col-md-offset-2 col-md-8 col-sm-offset-2 col-sm-8 index-header">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse"
data-target="#example-navbar-collapse">
<span class="sr-only">切换导航</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a href="/index.html" class="logo"><img src="../static/img_logo.png"></a>
</div>
<ul class="header-title hidden-xs">
<li class="header-phone-selected">
<a href="/index.html">Home</a>
</li>
<li>
<a href="/document.html" class="header-selected">Guide</a>
<span class="header-title-selected"></span>
</li>
<li>
<a href="//edu.qpython.org/">Course</a>
</li>
<li>
<a href="//www.aipy.org">AIPY</a>
</li>
<li>
<a target="_blank" href="//github.com/qpython-android/qpython">Github</a>
</li>
</ul>
<div class="search-box hidden-xs">
<form action="../search.html">
<input type="search" name="q" placeholder="keyword">
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
<button><img src="../static/ic_search.png"></button>
</form>
</div>
</div>
</div>
<div class="row doc-content">
<div class="content-main col-sm-offset-2 col-sm-8">
<div class="content-wrapper col-sm-4">
<div class="left-menu">
<div class="doc-title hidden-xs">QPython</div>
<div class="sidebar collapse navbar-collapse" id="example-navbar-collapse">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="guide.html">Getting started</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="guide.html#programming-guide">Programming Guide</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">QPython’s main features</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#why-should-i-choose-qpython">Why should I choose QPython</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id1">QPython’s main features</a></li>
</ul>
</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">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="guide.html#developer-guide">Developer Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide.html#contributor-guide">Contributor Guide</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="faq.html">FAQ</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../zhindex.html">中文用户向导</a></li>
</ul>
<div class="search-phone visible-xs">
<form action="../search.html">
<input type="search" name="q" placeholder="keyword">
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
<button><img src="../static/ic_search.png"></button>
</form>
</div>
</div>
</div>
</div>
<div class="content col-sm-8">
<div class="document">
<ul class="crumbs">
<li><a href="../document.html">Guide</a> &raquo;</li>
<li><a href="guide.html">Getting started</a> &raquo;</li>
<li>QPython’s main features</li>
</ul>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="qpython-s-main-features">
<h1>QPython’s main features<a class="headerlink" href="#qpython-s-main-features" title="Permalink to this headline">¶</a></h1>
<p><strong>With QPython, you could build android applications with android application and script language now.</strong></p>
<div class="section" id="why-should-i-choose-qpython">
<h2>Why should I choose QPython<a class="headerlink" href="#why-should-i-choose-qpython" title="Permalink to this headline">¶</a></h2>
<p>The smartphone is becomming people’s essential information &amp; technical assitant, so an flexiable script engine could help people complete most jobs efficiently without complex development.</p>
<p>QPython offer <strong>an amazing developing experience</strong>, with it’s help, you could implement the program easily without complex installing IDE, compiling, package progress etc.</p>
</div>
<div class="section" id="id1">
<h2>QPython’s main features<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
<p>You can do most jobs through QPython just like the way that Python does on PC/Laptop.</p>
<p><strong>Libraries</strong></p>
<ul class="simple">
<li>QPython supports most stardard Python libraries.</li>
<li>QPython supports many 3rd Python libraries which implemented with pure Python code.</li>
<li>QPython supports some Python libraries mixed with C/C++ code which pre-compiled by QPython develop team.</li>
<li>QPython allows you put on the libraries by yourself.</li>
</ul>
<p>Besides these, QPython offers some extra features which Python doesn’t offer, Like:</p>
<ul class="simple">
<li>Android APIs Access(Like SMS, GPS, NFC, BLUETOOTH etc)</li>
</ul>
<p><em>Why QPython require so many permissions?</em></p>
<p>QPython need these permissions to access Android’s API.</p>
<p><strong>Runtime modes</strong></p>
<p>QPython supports several runtime modes for android.</p>
<p><strong>Console mode</strong></p>
<p>It’s the default runtime mode in QPython, it’s very common in PC/laptop.</p>
<p><strong>Kivy mode</strong></p>
<p>QPython supports <a class="reference external" href="http://kivy.org">Kivy</a> as the GUI programming solution.</p>
<p>Kivy is an open source Python library for rapid development of applications that make use of innovative user interfaces, such as multi-touch apps.</p>
<p>Your device should support opengl2.0 for supporting kivy mode.</p>
<p>By insert into the following header in your script, you can let your script run with kivy mode.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:kivy</span>
</pre></div>
</div>
<p><em>An kivy program in QPython sample</em></p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:kivy</span>
<span class="kn">from</span> <span class="nn">kivy.app</span> <span class="k">import</span> <span class="n">App</span>
<span class="kn">from</span> <span class="nn">kivy.uix.button</span> <span class="k">import</span> <span class="n">Button</span>
<span class="k">class</span> <span class="nc">TestApp</span><span class="p">(</span><span class="n">App</span><span class="p">):</span>
<span class="k">def</span> <span class="nf">build</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">return</span> <span class="n">Button</span><span class="p">(</span><span class="n">text</span><span class="o">=</span><span class="s1">&#39;Hello World&#39;</span><span class="p">)</span>
<span class="n">TestApp</span><span class="p">()</span><span class="o">.</span><span class="n">run</span><span class="p">()</span>
</pre></div>
</div>
<p>If your library require the opengl driver, you shoule declare the kivy mode header in your script, like the jnius.</p>
<p><em>NOTE: QPython3 didn’t support kivy mode yet, we have plan to support it in the future</em></p>
<p><strong>WebApp mode</strong></p>
<p>We recommend you implement WebApp with QPython for it offer the easy to accomplish UI and Take advantage of Python’s fast programming strong point.</p>
<p>WebApp will start a webview in front, and run a python web service background.
You could use <em>bottle*(QPython built-in library) to implement the web service, or you could install *django</em> / <em>flask</em> framework also.</p>
<p>By insert into the following header in your script, you can let your script run with webapp mode.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:webapp:&lt;app title&gt;</span>
<span class="c1">#qpy:&lt;fullscreen or remove this line&gt;</span>
<span class="c1">#qpy://&lt;ip:port:path&gt;</span>
</pre></div>
</div>
<p>For example</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:webapp:Hello QPython</span>
<span class="c1">#qpy://localhost:8080/hello</span>
</pre></div>
</div>
<p>The previous should start a webview which should load the <em>http://localhost:8080/hello</em> as the default page, and the webview will keep the titlebar which title is "Hello QPython", if you add the <em>#qpy:fullscreen</em> it will hide the titlebar.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:webapp:Hello Qpython</span>
<span class="c1">#qpy://127.0.0.1:8080/</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd">This is a sample for qpython webapp</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="kn">from</span> <span class="nn">bottle</span> <span class="k">import</span> <span class="n">Bottle</span><span class="p">,</span> <span class="n">ServerAdapter</span>
<span class="kn">from</span> <span class="nn">bottle</span> <span class="k">import</span> <span class="n">run</span><span class="p">,</span> <span class="n">debug</span><span class="p">,</span> <span class="n">route</span><span class="p">,</span> <span class="n">error</span><span class="p">,</span> <span class="n">static_file</span><span class="p">,</span> <span class="n">template</span>
<span class="c1">######### QPYTHON WEB SERVER ###############</span>
<span class="k">class</span> <span class="nc">MyWSGIRefServer</span><span class="p">(</span><span class="n">ServerAdapter</span><span class="p">):</span>
<span class="n">server</span> <span class="o">=</span> <span class="kc">None</span>
<span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">handler</span><span class="p">):</span>
<span class="kn">from</span> <span class="nn">wsgiref.simple_server</span> <span class="k">import</span> <span class="n">make_server</span><span class="p">,</span> <span class="n">WSGIRequestHandler</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">quiet</span><span class="p">:</span>
<span class="k">class</span> <span class="nc">QuietHandler</span><span class="p">(</span><span class="n">WSGIRequestHandler</span><span class="p">):</span>
<span class="k">def</span> <span class="nf">log_request</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kw</span><span class="p">):</span> <span class="k">pass</span>
<span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s1">&#39;handler_class&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">QuietHandler</span>
<span class="bp">self</span><span class="o">.</span><span class="n">server</span> <span class="o">=</span> <span class="n">make_server</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">host</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">,</span> <span class="n">handler</span><span class="p">,</span> <span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">server</span><span class="o">.</span><span class="n">serve_forever</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="c1">#sys.stderr.close()</span>
<span class="kn">import</span> <span class="nn">threading</span>
<span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">server</span><span class="o">.</span><span class="n">shutdown</span><span class="p">)</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
<span class="c1">#self.server.shutdown()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">server</span><span class="o">.</span><span class="n">server_close</span><span class="p">()</span> <span class="c1">#&lt;--- alternative but causes bad fd exception</span>
<span class="nb">print</span> <span class="s2">&quot;# qpyhttpd stop&quot;</span>
<span class="c1">######### BUILT-IN ROUTERS ###############</span>
<span class="nd">@route</span><span class="p">(</span><span class="s1">&#39;/__exit&#39;</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;GET&#39;</span><span class="p">,</span><span class="s1">&#39;HEAD&#39;</span><span class="p">])</span>
<span class="k">def</span> <span class="nf">__exit</span><span class="p">():</span>
<span class="k">global</span> <span class="n">server</span>
<span class="n">server</span><span class="o">.</span><span class="n">stop</span><span class="p">()</span>
<span class="nd">@route</span><span class="p">(</span><span class="s1">&#39;/assets/&lt;filepath:path&gt;&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">serverstatic</span><span class="p">(</span><span class="n">filepath</span><span class="p">):</span>
<span class="k">return</span> <span class="n">static_file</span><span class="p">(</span><span class="n">filepath</span><span class="p">,</span> <span class="n">root</span><span class="o">=</span><span class="s1">&#39;/sdcard&#39;</span><span class="p">)</span>
<span class="c1">######### WEBAPP ROUTERS ###############</span>
<span class="nd">@route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">home</span><span class="p">():</span>
<span class="k">return</span> <span class="n">template</span><span class="p">(</span><span class="s1">&#39;&lt;h1&gt;Hello {{name}} !&lt;/h1&gt;&#39;</span><span class="o">+</span> \
<span class="s1">&#39;&lt;a href=&quot;/assets/qpython/projects/WebApp Sample/main.py&quot;&gt;View source&lt;/a&gt;&#39;</span><span class="p">,</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;QPython&#39;</span><span class="p">)</span>
<span class="c1">######### WEBAPP ROUTERS ###############</span>
<span class="n">app</span> <span class="o">=</span> <span class="n">Bottle</span><span class="p">()</span>
<span class="n">app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/&#39;</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s1">&#39;GET&#39;</span><span class="p">)(</span><span class="n">home</span><span class="p">)</span>
<span class="n">app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/__exit&#39;</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;GET&#39;</span><span class="p">,</span><span class="s1">&#39;HEAD&#39;</span><span class="p">])(</span><span class="n">__exit</span><span class="p">)</span>
<span class="n">app</span><span class="o">.</span><span class="n">route</span><span class="p">(</span><span class="s1">&#39;/assets/&lt;filepath:path&gt;&#39;</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s1">&#39;GET&#39;</span><span class="p">)(</span><span class="n">serverstatic</span><span class="p">)</span>
<span class="k">try</span><span class="p">:</span>
<span class="n">server</span> <span class="o">=</span> <span class="n">MyWSGIRefServer</span><span class="p">(</span><span class="n">host</span><span class="o">=</span><span class="s2">&quot;127.0.0.1&quot;</span><span class="p">,</span> <span class="n">port</span><span class="o">=</span><span class="s2">&quot;8080&quot;</span><span class="p">)</span>
<span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">server</span><span class="o">=</span><span class="n">server</span><span class="p">,</span><span class="n">reloader</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
<span class="k">except</span> <span class="ne">Exception</span><span class="p">,</span><span class="n">ex</span><span class="p">:</span>
<span class="nb">print</span> <span class="s2">&quot;Exception: </span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="nb">repr</span><span class="p">(</span><span class="n">ex</span><span class="p">)</span>
</pre></div>
</div>
<p>If you want the webapp could be close when you exit the webview, you have to define the <em>&#64;route(‘/__exit’, method=[‘GET’,’HEAD’])</em> method , for the qpython will request the <em>http://localhost:8080/__exit</em> when you exit the webview. So you can release other resource in this function.</p>
<img alt="QPython WebApp Sample" src="../images/guide_program_pic1.png" />
<p><em>Running screenshot</em></p>
<p>In the other part of the code, you could implement a webserver whish serve on localhost:8080 and make the URL /hello implement as your webapp’s homepage.</p>
<p><strong>Q mode</strong></p>
<p>If you don’t want the QPython display some UI, pelase try to use the QScript mode, it could run a script background, just insert the following header into your script:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1">#qpy:qpyapp</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="fb-comments" data-href="http://qpython.org" data-numposts="10"></div>
</div>
</div>
<div class="col-sm-2"></div>
</div>
<footer id="footer">
<div class="col-sm-offset-2 col-sm-6 footer-div1">
<div class="footer-block-item">
<span class="footer-item1">Built with Sphinx using a theme provid by QPython.</span>
<span class="footer-item2 visible-xs">
&#169; Copyright 2017, QPython.
</span>
</div>
</div>
<div class="col-sm-2 footer-div2">
<a href="/index.html" class="pull-right"><img src="../static/img_logo.png"></a>
</div>
</footer>
<script type="text/javascript">
$('.fb-comments').attr('data-href', (window.location.href.split('#')[0]).split('?')[0])
(function(d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) return;
js = d.createElement(s); js.id = id;
js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.8&appId=1680815145503311";
fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));
$(function(){
if ($('#footer')[0].offsetTop < $(window).height()){
$('#footer').addClass('to-bottom')
}
})
</script>
</body>
</html>