You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@weex.apache.org by ji...@apache.org on 2017/02/20 06:41:37 UTC

[48/50] [abbrv] incubator-weex git commit: * [doc] updated guide/intro/app-arch

* [doc] updated guide/intro/app-arch


Project: http://git-wip-us.apache.org/repos/asf/incubator-weex/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-weex/commit/7d94533a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-weex/tree/7d94533a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-weex/diff/7d94533a

Branch: refs/heads/master
Commit: 7d94533a629939ea504afd81986fb7e69d9a8659
Parents: 7737d9f
Author: Jinjiang <zh...@me.com>
Authored: Fri Feb 17 14:46:53 2017 +0800
Committer: Jinjiang <zh...@me.com>
Committed: Fri Feb 17 14:46:53 2017 +0800

----------------------------------------------------------------------
 doc/source/cn/guide/intro/app-architecture.md | 34 ++++---------
 doc/source/guide/intro/app-architecture.md    | 57 ++++++++++++++++++++--
 doc/source/guide/intro/index.md               |  4 +-
 doc/source/guide/intro/page-architecture.md   |  4 +-
 doc/source/guide/intro/using-vue.md           |  2 +-
 doc/source/guide/intro/web-dev-experience.md  |  2 +-
 doc/source/guide/intro/write-once.md          |  2 +-
 7 files changed, 70 insertions(+), 35 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/cn/guide/intro/app-architecture.md
----------------------------------------------------------------------
diff --git a/doc/source/cn/guide/intro/app-architecture.md b/doc/source/cn/guide/intro/app-architecture.md
index 556f72a..a3f39ce 100644
--- a/doc/source/cn/guide/intro/app-architecture.md
+++ b/doc/source/cn/guide/intro/app-architecture.md
@@ -31,10 +31,9 @@ version: 2.1
 |------|------|------|------| |-----|
 | page | page | page | page | | api |
 |------|------|------|------| | api |
-|------|------|------|------| | api |
 | page | page | page | page | | api |
 |------|------|------|------| | api |
-                              | api |
+| page | page | page | page | | api |
 |---------------------------| | api |
 |           router          | | api |
 |---------------------------| |-----|
@@ -44,34 +43,19 @@ version: 2.1
 * \u8def\u7531\uff1a\u8fd9\u4e9b\u9875\u9762\u5c06\u4f1a\u901a\u8fc7\u8def\u7531\u673a\u5236\u6709\u673a\u7684\u4e32\u8054\u8d77\u6765\uff0c\u9875\u9762\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u901a\u8fc7\u8def\u7531\u6765\u8fdb\u884c\u8c03\u5ea6\u7684\u3002\u5e38\u89c1\u7684\u79fb\u52a8\u5e94\u7528\u8def\u7531\u5305\u62ec\u5bfc\u822a\u680f\u3001tab \u5207\u6362\u7b49\u3002
 * \u8bbe\u5907\u80fd\u529b\uff1a\u4ee5\u5404\u79cd API \u6216\u670d\u52a1\u7684\u65b9\u5f0f\u63d0\u4f9b\u51fa\u6765\uff0c\u4f9b\u9875\u9762\u81ea\u7531\u4f7f\u7528\u3002
 
-## \u5de5\u4f5c\u5206\u89e3
-
-### \u524d\u671f\u8bbe\u8ba1
-
-\u786e\u5b9a\u4e00\u4e2a\u79fb\u52a8\u5e94\u7528\u6709\u591a\u5c11\u9875\u9762\uff0c\u6bcf\u4e2a\u9875\u9762\u5206\u522b\u662f\u4ec0\u4e48 URL\uff0c\u9875\u9762\u4e4b\u95f4\u7684\u5173\u8054\u548c\u8df3\u8f6c\u903b\u8f91\u662f\u600e\u6837\u7684\uff0c\u7136\u540e\u68b3\u7406\u6574\u4e2a\u79fb\u52a8\u5e94\u7528\u9700\u8981\u7684\u6240\u6709 API \u548c\u670d\u52a1\u3002
-
-### \u811a\u624b\u67b6
+\u8fd9\u6837\u7684\u8bdd\uff0c\u5728\u6784\u5efa\u4e00\u4e2a\u5b8c\u6574\u7684\u79fb\u52a8\u5e94\u7528\u4e4b\u524d\uff0c\u5148\u786e\u5b9a\u4f60\u7684\u5e94\u7528\u6709\u591a\u5c11\u9875\u9762\uff0c\u6bcf\u4e2a\u9875\u9762\u5206\u522b\u662f\u4ec0\u4e48 URL\uff0c\u9875\u9762\u4e4b\u95f4\u7684\u5173\u8054\u548c\u8df3\u8f6c\u903b\u8f91\u662f\u600e\u6837\u7684\uff0c\u7136\u540e\u68b3\u7406\u6574\u4e2a\u79fb\u52a8\u5e94\u7528\u9700\u8981\u7684\u6240\u6709 API \u548c\u670d\u52a1\u3002
 
-\u9996\u5148\u6211\u4eec\u9700\u8981\u4e00\u4e2a Weex \u79fb\u52a8\u5e94\u7528\u7684\u811a\u624b\u67b6\uff0c\u901a\u8fc7\u8fd9\u4e2a\u811a\u624b\u67b6\u6211\u4eec\u80fd\u591f\u521d\u59cb\u5316\u4e00\u4e2a iOS \u5de5\u7a0b\u3001\u4e00\u4e2a Android \u5de5\u7a0b\u6216\u4e00\u4e2a web \u5de5\u7a0b\u3002\u5e76\u5728\u5176\u4e2d\u5b9a\u4e49\u4e00\u4e9b\u57fa\u672c\u7684\u914d\u7f6e\u4fe1\u606f\u548c\u8def\u7531\u89c4\u5219\u3002
+\u7136\u540e\u901a\u8fc7 Weex \u521b\u5efa\u4e0d\u540c\u7684\u9875\u9762\uff0c\u5e76\u5206\u522b\u8fdb\u884c\u5f00\u53d1\u3001\u8c03\u8bd5\u548c\u53d1\u5e03\u3002
 
-<!-- weex-pack -->
+**\u76f8\u5173\u94fe\u63a5**
 
-### \u9875\u9762
+* [\u9875\u9762\u7ed3\u6784](./page-architecture.html)
 
-\u7136\u540e\u6211\u4eec\u901a\u8fc7 Weex \u9875\u9762\u811a\u624b\u67b6\u6765\u521b\u5efa\u4e00\u4e2a\u4e2a\u72ec\u7acb\u7684 Weex \u9875\u9762\uff0c\u5e76\u5206\u522b\u8fdb\u884c\u5f00\u53d1\u3001\u8c03\u8bd5\u548c\u53d1\u5e03\u3002
-
-<!-- \u9875\u9762\u7ed3\u6784 -->
-
-### \u6269\u5c55
+\u5982\u679c\u4f60\u5df2\u7ecf\u6709\u4e00\u4e2a\u505a\u597d\u7684\u79fb\u52a8\u5e94\u7528\uff0c\u53ea\u60f3\u7528 Weex \u5f00\u53d1\u5176\u4e2d\u7684\u4e00\u90e8\u5206\u9875\u9762\u751a\u81f3\u4ec5\u4ec5\u5176\u4e2d\u7684\u4e00\u4e24\u4e2a\u9875\u9762\uff0c\u8fd9\u5bf9 Weex \u6765\u8bf4\u5b8c\u5168\u4e0d\u662f\u95ee\u9898\u3002Weex \u53ea\u662f\u4e00\u4e2a SDK\uff0c\u5bf9\u6574\u4f53\u7684\u79fb\u52a8\u5e94\u7528\u67b6\u6784\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u4fb5\u5165\u6027\u3002\u5e76\u4e14\u5b8c\u5168\u53ef\u4ee5\u548c\u7eaf native \u754c\u9762\u6216 hybrid \u9875\u9762\u5171\u5b58\u3002
 
 \u5982\u679c\u9700\u8981 WeexSDK \u989d\u5916\u7684\u7ec4\u4ef6\u3001\u6a21\u5757\u6216\u5176\u5b83\u529f\u80fd\uff0c\u53ef\u4ee5\u901a\u8fc7 Weex \u7684\u6269\u5c55\u673a\u5236\u8fdb\u884c\u6269\u5c55\u3002\u8fd9\u90e8\u5206\u5de5\u4f5c\u9700\u8981 native \u7684\u7814\u53d1\u77e5\u8bc6\uff0c\u4f46\u662f\u968f\u7740 Weex \u7ec4\u4ef6\u548c\u6a21\u5757\u7684\u4e30\u5bcc\u4ee5\u53ca\u4e1a\u52a1\u8fed\u4ee3\u7684\u6df1\u5165\uff0c\u8fd9\u90e8\u5206\u6210\u672c\u4f1a\u627f\u4e0b\u964d\u548c\u6536\u655b\u7684\u8d8b\u52bf\u3002
 
-<!-- \u6269\u5c55 iOS -->
-
-<!-- \u6269\u5c55 Android -->
-
-### \u4e91\u7aef
-
-\u5728\u4e91\u7aef\u90e8\u7f72\u76f8\u5e94\u7684 JS bundle\uff0c\u540c\u65f6\u901a\u8fc7\u7f13\u5b58\u6216\u9884\u52a0\u8f7d\u7b49\u65b9\u5f0f\u52a0\u901f Weex \u9875\u9762\u7684\u52a0\u8f7d\u65f6\u95f4\u548c\u9996\u5c4f\u6e32\u67d3\u65f6\u95f4\u3002
+**\u76f8\u5173\u94fe\u63a5**
 
-\u8fd9\u6837\uff0c\u4ece\u79fb\u52a8\u5e94\u7528\u6574\u4f53\u67b6\u6784\u3001\u5230\u9875\u9762\u5f00\u53d1\u548c\u529f\u80fd\u6269\u5c55\uff0c\u518d\u5230\u4e91\u7aef\u7684\u90e8\u7f72\u548c\u5206\u53d1\uff0c\u4e00\u4e2a\u5b8c\u6574\u7684 Weex \u5e94\u7528\u5c31\u53ef\u4ee5\u6784\u5efa\u51fa\u6765\u3002
\ No newline at end of file
+* [\u5982\u4f55\u6269\u5c55 iOS](../../references/advanced/extend-to-ios.html)
+* [\u5982\u4f55\u6269\u5c55 Android](../../references/advanced/extend-to-android.html)

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/app-architecture.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/app-architecture.md b/doc/source/guide/intro/app-architecture.md
index 86e89ad..d7b3bc6 100644
--- a/doc/source/guide/intro/app-architecture.md
+++ b/doc/source/guide/intro/app-architecture.md
@@ -1,10 +1,61 @@
 ---
-title: App Architecture  
+title: Mobile App Architecture
 type: guide
 order: 4.5
 version: 2.1
 ---
 
-# App Architecture
+# Mobile App Architecture
 
-Work in progress.
\ No newline at end of file
+## Today's Mobile App
+
+Let's talk about what we think a mobile app should be.
+
+### Mobile App Needs Parallel Development
+
+Nowadays, all mobile app teams requires the ability to develop in parallel. When a mobile app keeps growing, supporting large-scale parallel development must become a very important key thing. Otherwise it's really easy to become a bottleneck.
+
+### Mobile App Needs to be Dynamic
+
+Today the development of mobile apps is very heavy. And it's really slow in iteration, release, distribution and online bugfix. The size of the package of an app is growing fast too. All of this is not suitable for this mobile internet age. Mobile app needs to be dynaimic which is out of the cumbersome process of version deployment and distribution.
+
+### Mobile App Needs Open Interconnection
+
+Today in your phone, things are hard to connect and share between different apps. They needs some container with common standard and specs to be shared with each other.
+
+## Our Thinking of Mobile App
+
+We think a dynamic, parallel development supported, standardized mobile app should be like this:
+
+```
+|------|------|------|------| |-----|
+| page | page | page | page | | api |
+|------|------|------|------| | api |
+| page | page | page | page | | api |
+|------|------|------|------| | api |
+| page | page | page | page | | api |
+|---------------------------| | api |
+|           router          | | api |
+|---------------------------| |-----|
+```
+
+* Pages: A whole mobile app should be divided into several mobile pages. Each mobile page has its own "URL".
+* Router: All the mobile pages above will be connected with router. And navigators or tab bars are just doing this job.
+* Features: All kinds of APIs or services provided from the device. Every mobile page could use these features as they like.
+
+So before you build your mobile app, make sure how many mobile pages your mobile app has and what are they. How do they connect each other. Give each mobile page a URL. And sort out all the APIs and services your mobile app needs.
+
+Then create the pages and develop, debug and deploy them using Weex.
+
+**Links**
+
+* [Mobile page architecture](./page-architecture.html)
+
+If you have built a complete mobile app already and just want to using Weex to rebuild part of these pages, that's absolutely no problem. Because Weex is just a SDK to build mobile pages which can coexist very well with other native views or hybrid pages.
+
+If the feature of WeexSDK is limited to your mobile app. You can extend your own components and modules. It requires some native development knowledge. But with our efforts on delivering more and more features, we believe this part of job will be getting smaller and smaller.
+
+**Links**
+
+* [Extend to iOS](../../references/advanced/extend-to-ios.html)
+* [Extend to Android](../../references/advanced/extend-to-android.html)

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/index.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/index.md b/doc/source/guide/intro/index.md
index 1b07ccd..24c8236 100644
--- a/doc/source/guide/intro/index.md
+++ b/doc/source/guide/intro/index.md
@@ -1,5 +1,5 @@
 ---
-title: Intro 
+title: Intro
 type: guide
 order: 4
 has_chapter_content: false
@@ -14,4 +14,4 @@ version: 2.1
 - [Using Vue](./using-vue.html)
 - [Write once, Run Everywhere](./write-once.html)
 - [App Architecture](./app-architecture.html)
-- [Weex Page Architecture](./page-architecture.html)
\ No newline at end of file
+- [Weex Page Architecture](./page-architecture.html)

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/page-architecture.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/page-architecture.md b/doc/source/guide/intro/page-architecture.md
index e353b98..73e5302 100644
--- a/doc/source/guide/intro/page-architecture.md
+++ b/doc/source/guide/intro/page-architecture.md
@@ -1,5 +1,5 @@
 ---
-title: Weex Page Architecture  
+title: Weex Page Architecture
 type: guide
 order: 4.6
 version: 2.1
@@ -7,4 +7,4 @@ version: 2.1
 
 # Weex Page Architecture
 
-Work in progress.
\ No newline at end of file
+Work in progress.

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/using-vue.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/using-vue.md b/doc/source/guide/intro/using-vue.md
index bc043ae..953d7fd 100644
--- a/doc/source/guide/intro/using-vue.md
+++ b/doc/source/guide/intro/using-vue.md
@@ -1,5 +1,5 @@
 ---
-title: Using Vue  
+title: Using Vue
 type: guide
 order: 4.3
 version: 2.1

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/web-dev-experience.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/web-dev-experience.md b/doc/source/guide/intro/web-dev-experience.md
index 026a02a..81d0ff2 100644
--- a/doc/source/guide/intro/web-dev-experience.md
+++ b/doc/source/guide/intro/web-dev-experience.md
@@ -1,5 +1,5 @@
 ---
-title: Web Dev Experience  
+title: Web Dev Experience
 type: guide
 order: 4.2
 version: 2.1

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/7d94533a/doc/source/guide/intro/write-once.md
----------------------------------------------------------------------
diff --git a/doc/source/guide/intro/write-once.md b/doc/source/guide/intro/write-once.md
index 282c992..382b7b4 100644
--- a/doc/source/guide/intro/write-once.md
+++ b/doc/source/guide/intro/write-once.md
@@ -1,5 +1,5 @@
 ---
-title: Write once, Run Everywhere  
+title: Write once, Run Everywhere
 type: guide
 order: 4.4
 version: 2.1