* [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 <zhaojinji...@me.com> Authored: Fri Feb 17 14:46:53 2017 +0800 Committer: Jinjiang <zhaojinji...@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 * è·¯ç±ï¼è¿äºé¡µé¢å°ä¼éè¿è·¯ç±æºå¶ææºç串èèµ·æ¥ï¼é¡µé¢ä¹é´çå ³ç³»æ¯éè¿è·¯ç±æ¥è¿è¡è°åº¦çã常è§ç移å¨åºç¨è·¯ç±å æ¬å¯¼èªæ ãtab åæ¢çã * 设å¤è½åï¼ä»¥åç§ API ææå¡çæ¹å¼æä¾åºæ¥ï¼ä¾é¡µé¢èªç±ä½¿ç¨ã -## å·¥ä½å解 - -### åæ设计 - -ç¡®å®ä¸ä¸ªç§»å¨åºç¨æå¤å°é¡µé¢ï¼æ¯ä¸ªé¡µé¢åå«æ¯ä»ä¹ URLï¼é¡µé¢ä¹é´çå ³èå跳转é»è¾æ¯ææ ·çï¼ç¶å梳çæ´ä¸ªç§»å¨åºç¨éè¦çææ API åæå¡ã - -### èææ¶ +è¿æ ·çè¯ï¼å¨æ建ä¸ä¸ªå®æ´ç移å¨åºç¨ä¹åï¼å ç¡®å®ä½ çåºç¨æå¤å°é¡µé¢ï¼æ¯ä¸ªé¡µé¢åå«æ¯ä»ä¹ URLï¼é¡µé¢ä¹é´çå ³èå跳转é»è¾æ¯ææ ·çï¼ç¶å梳çæ´ä¸ªç§»å¨åºç¨éè¦çææ API åæå¡ã -é¦å æ们éè¦ä¸ä¸ª Weex 移å¨åºç¨çèææ¶ï¼éè¿è¿ä¸ªèææ¶æ们è½å¤åå§åä¸ä¸ª iOS å·¥ç¨ãä¸ä¸ª Android å·¥ç¨æä¸ä¸ª web å·¥ç¨ã并å¨å ¶ä¸å®ä¹ä¸äºåºæ¬çé 置信æ¯åè·¯ç±è§åã +ç¶åéè¿ Weex å建ä¸åç页é¢ï¼å¹¶åå«è¿è¡å¼åãè°è¯ååå¸ã -<!-- weex-pack --> +**ç¸å ³é¾æ¥** -### é¡µé¢ +* [页é¢ç»æ](./page-architecture.html) -ç¶åæ们éè¿ Weex 页é¢èææ¶æ¥å建ä¸ä¸ªä¸ªç¬ç«ç Weex 页é¢ï¼å¹¶åå«è¿è¡å¼åãè°è¯ååå¸ã - -<!-- 页é¢ç»æ --> - -### æ©å± +å¦æä½ å·²ç»æä¸ä¸ªå好ç移å¨åºç¨ï¼åªæ³ç¨ Weex å¼åå ¶ä¸çä¸é¨å页é¢çè³ä» ä» å ¶ä¸çä¸ä¸¤ä¸ªé¡µé¢ï¼è¿å¯¹ Weex æ¥è¯´å®å ¨ä¸æ¯é®é¢ãWeex åªæ¯ä¸ä¸ª SDKï¼å¯¹æ´ä½ç移å¨åºç¨æ¶æä¸ä¼äº§çä»»ä½ä¾µå ¥æ§ã并ä¸å®å ¨å¯ä»¥å纯 native çé¢æ hybrid 页é¢å ±åã å¦æéè¦ WeexSDK é¢å¤çç»ä»¶ã模åæå ¶å®åè½ï¼å¯ä»¥éè¿ Weex çæ©å±æºå¶è¿è¡æ©å±ãè¿é¨åå·¥ä½éè¦ native çç åç¥è¯ï¼ä½æ¯éç Weex ç»ä»¶å模åç丰å¯ä»¥åä¸å¡è¿ä»£çæ·±å ¥ï¼è¿é¨åææ¬ä¼æ¿ä¸éåæ¶æçè¶å¿ã -<!-- æ©å± iOS --> - -<!-- æ©å± Android --> - -### äºç«¯ - -å¨äºç«¯é¨ç½²ç¸åºç JS bundleï¼åæ¶éè¿ç¼åæé¢å è½½çæ¹å¼å é Weex 页é¢çå è½½æ¶é´åé¦å±æ¸²ææ¶é´ã +**ç¸å ³é¾æ¥** -è¿æ ·ï¼ä»ç§»å¨åºç¨æ´ä½æ¶æãå°é¡µé¢å¼åååè½æ©å±ï¼åå°äºç«¯çé¨ç½²åååï¼ä¸ä¸ªå®æ´ç Weex åºç¨å°±å¯ä»¥æ建åºæ¥ã \ No newline at end of file +* [å¦ä½æ©å± iOS](../../references/advanced/extend-to-ios.html) +* [å¦ä½æ©å± 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
