Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 48dd7bc

Browse filesBrowse files
halfrosthalfrost
committed
完善 markdown
1 parent 344fe07 commit 48dd7bc
Copy full SHA for 48dd7bc

31 files changed

+305
-12
lines changed

‎README.md

Copy file name to clipboardExpand all lines: README.md
+305-12Lines changed: 305 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,70 @@
1616

1717
利用 Vue.js 实现 [objc中国](https://objccn.io/) 的跨平台全栈应用
1818

19-
- [x] 桌面应用，支持 Mac、Linux、Windows 三个平台
20-
- [x] Web 应用，支持 桌面浏览器 和 手机浏览器
21-
- [x] 手机 App，目前只支持了 Cordova 框架
22-
- [ ] 手机原生 App，打算用 Weex 框架
19+
- [x] ✅桌面应用，支持 Mac、Linux、Windows 三个平台
20+
- [x] ✅Web 应用，支持 桌面浏览器 和 手机浏览器
21+
- [x] ✅手机 App，目前只支持了 Cordova 框架，支持 iOS 和 Android 两个平台
22+
- [ ] ❌手机原生 App，打算用 Weex 框架，同样一起支持 iOS 和 Android 两个平台
2323

24+
> 注：此项目纯属个人瞎搞，请大家支持 喵神(@onevcat)，支持 [Objc中国](https://objccn.io/)。
2425
25-
## Build Setup
26+
# 前言
27+
28+
## 一.关于我
29+
30+
我是一名全职的 iOS 开发者，非前端开发者。由于接触了 Weex 开发，从而接触到了 Vue.js。
31+
32+
## 二.为什么会写这个项目？
33+
34+
1. 最开始有这个想法的时候是来自一个网友，他在我的博客上问我，网上有没有写的比较好的 demo ？我说尤大写的那个 Hacker News 是最好的。后来网友就是，楼主能写一个么？我当时回答暂时不行。其实这事我一直记在心里。
35+
36+
2. 今年5月19号，GitHub 使用 Electron 重写了 macOS 和 Windows 的客户端，加上近些年跨端开发越来越火，对于一些公司来说，Web 和 app 应该都是需要的，app 还需要 iOS 和 Android 两个平台，再有甚者还要开发小程序，桌面级的应用虽然少，但是用 Electron 一样可以一起开发了。自己也萌生了想要跃跃欲试的念头。
37+
38+
3. 由于接触到了 Vue.js，当然不想停留在初级，想进阶，尤大给出了建议，就是多实践，多练。为了加快进阶的步伐，自己私下就找项目练。
39+
40+
4. 至于为何选择 Objc 中国，理由其实很简单，因为我是 iOS 开发者。在 iOS 开发者中，Objc 基本上人尽皆知（有不知道的？），喵神也基本上人尽皆知，我个人很崇拜喵神，所以就选了 Objc 中国来写。
41+
42+
5. 因为爱 ... ...
43+
44+
## 三.这次为何跨端开发没有weex？
45+
46+
这次在我写完项目以后，发现 Vue 的代码直接转换成 Weex 的项目，是无法实现的，好多报错。而且不是一下子能都修复好。我相信是我使用姿势的问题，不是 Weex 的问题。对了，Weex 又发布新版本了，接下来有时间的话就把 Weex 版的也做一遍开源。
47+
48+
好了，进入正题，说项目：
49+
50+
------
51+
52+
# 技术栈和主要框架
53+
54+
📦Vue 全家桶：vue2 + vuex + vue-router + webpack
55+
📌ES6
56+
📡网络请求：axios
57+
🎈页面相应式框架：bootstrap，element-ui
58+
✏️后台：express
59+
📝代码高亮：highlight.js
60+
🗄数据库：lowdb
61+
📖markdown解析器：vue-markdown
62+
🔖表单验证：vee-validate
63+
🏆跨平台框架：Electron
64+
65+
# 🔨项目构建
66+
67+
由于喵神的 Objc 网站是直接返回 html，所以想进行模拟网络请求返回数据，就只能自己搭建一个后台，写 api 返回数据了。
68+
69+
我利用 Express 把后台搭建在 8081端口上，并写好路由，请求会转到8080，开启服务器的时候也会自动开启后台。
2670

2771
``` bash
28-
# install dependencies
72+
73+
# install dependencies 安装依赖
2974
npm install
3075

3176
# serve with hot reload at localhost:8080
3277
npm run dev
3378

34-
# build for production with minification
79+
# serve with hot reload at localhost:8080
80+
npm run start
81+
82+
# build for production with minification 打包
3583
npm run build
3684

3785
# build for production and view the bundle analyzer report
@@ -45,33 +93,278 @@ npm run e2e
4593

4694
# run all tests
4795
npm test
96+
97+
# 打包 Mac 应用
98+
npm run build:mac
99+
100+
# 打包 Linux 应用
101+
npm run build:linux
102+
103+
# 打包 Win 应用
104+
npm run build:win
105+
106+
# 打包 Cordova 应用
107+
npm run build:app
108+
48109
```
49110

50-
For detailed explanation on how things work, checkout the [guide](http://vuejs-templates.github.io/webpack/) and [docs for vue-loader](http://vuejs.github.io/vue-loader).
111+
这里要单独说一下 Cordova 的打包方式，它比桌面端的稍微特殊一点。
112+
我在项目中放了一个 Makefile，可以根据这个来做。
113+
114+
1. 首先全局安装 cordova 命令
115+
> npm install -g cordova
116+
117+
2. 再输入下面的命令，生成 app 项目目录
118+
> cordova create app com.vueobjccn vueobjccn
119+
120+
3. 进入到 app 文件夹中
121+
> cd app
122+
123+
4. 添加对应的平台
124+
> cordova platform add ios
125+
> cordova platform add android
126+
127+
5. 运行项目
128+
> cordova run ios
129+
> cordova run android
130+
131+
Cordova 只生成了一个壳的 app，里面具体的内容还是读取的网页，在生成的对应的应用里面有一个 www 的文件夹，这个文件夹里面就是要加载页面。JavaScript 打包之后是会生成 www 的文件夹，只要去替换 Cordova 对应平台里面的 www 文件夹里面的内容即可。
132+
133+
额外说几句，在 app 发展到现在这么成熟的时代，如果构建一个大的 app，用 Cordova 框架去做，不用原生，不做任何优化，用户体验确实不如原生的快。我这次就专门打包体验了 Cordova app，没有做任何优化，打包出来就用，如果是挑剔的用户，放在当今各大 app 接近完美的体验度相比来说，确实会感到满足感略低。如果真的要前端开发 app ，给2个建议，如果是用 Cordova 框架，一定要尽量优化优化，不如性能不如原生。如果想有接近原生的体验，那么可以考虑用 React Native 或者 Weex。
51134

52135

53-
# 跨平台开发
136+
# 🚀 跨平台开发
54137

55138

139+
JavaScript 跨平台开发打包成桌面级应用，主要用 Electron 框架。这里需要在 devDependencies 里面安装好 "electron"、"electron-builder"、"electron-packager" 这三个。其他的路径配置在 webpack 里面配置好即可。
140+
56141
关于 Cordova 的安装，确实可以吐槽一点网络的问题。如果你在一个翻墙环境很差的地方，真的很痛苦。比如之前在一个翻墙环境很差的情况下全局安装 Cordova ，各种报错，就算是换了 cnpm 完全安装了以后，添加 iOS 平台以后以后会报一个 co 文件找不到的问题，感觉是 cnpm 没有把命令安装完整。后来我回到家里，翻墙网络很好，npm install 一下子就安装好了。不过有个小插曲：Cordova iOS 4.4.0 template 如果报错，就多安装几次，原因还是翻墙的原因，没有 catch 到。
57142

143+
还有可能会遇到下面这个错误：
144+
145+
> "Error: Cannot find module 'config-chain'" when running 'ionic start'
146+
147+
这个错误就用 sudo 命令重新尝试一遍原命令就好了。
148+
149+
最终打包完成会在 dist 的文件夹中。
150+
151+
152+
接下来展示一下这个跨三端的应用在各个平台下的表现：
153+
154+
先展示一下 Web 端
155+
156+
<p align='center'>
157+
<img src='./image/Screenshots/Web/Web 1.png'>
158+
</p>
159+
160+
<p align='center'>
161+
<img src='./image/Screenshots/Web/Web 2.png'>
162+
</p>
163+
164+
<p align='center'>
165+
<img src='./image/Screenshots/Web/Web 3.png'>
166+
</p>
167+
168+
<p align='center'>
169+
<img src='./image/Screenshots/Web/Web 4.png'>
170+
</p>
171+
172+
<p align='center'>
173+
<img src='./image/Screenshots/Web/Web 5.png'>
174+
</p>
175+
176+
再展示一下在手机浏览器上的效果：
177+
178+
Android平台
179+
180+
Nexus 5x 的 Web
181+
<p align='center'>
182+
<img src='./image/Screenshots/Web/Nexus 5x Web.png'>
183+
</p>
184+
185+
Nexus 6P 的 Web
186+
<p align='center'>
187+
<img src='./image/Screenshots/Web/Nexus 6P Web.png'>
188+
</p>
189+
190+
iOS 平台
191+
192+
iPhone 5 的 Web
193+
<p align='center'>
194+
<img src='./image/Screenshots/Web/iPhone 5 Web.png'>
195+
</p>
196+
197+
iPhone 7 的 Web
198+
<p align='center'>
199+
<img src='./image/Screenshots/Web/iPhone 7 Web.png'>
200+
</p>
201+
202+
iPhone 7 Plus 的 Web
203+
<p align='center'>
204+
<img src='./image/Screenshots/Web/iPhone 7 Plus Web.png'>
205+
</p>
206+
207+
iPad 的 Web
208+
209+
<p align='center'>
210+
<img src='./image/Screenshots/Web/iPad Web.png'>
211+
</p>
212+
213+
214+
接着再看看 Mac 端上的表现：
215+
216+
<p align='center'>
217+
<img src='./image/Screenshots/Mac/Mac 1.png'>
218+
</p>
219+
220+
<p align='center'>
221+
<img src='./image/Screenshots/Mac/Mac 2.png'>
222+
</p>
223+
224+
225+
<p align='center'>
226+
<img src='./image/Screenshots/Mac/Mac 3.png'>
227+
</p>
228+
229+
<p align='center'>
230+
<img src='./image/Screenshots/Mac/Mac 4.png'>
231+
</p>
232+
233+
最后看看 Cordova 的效果：
234+
235+
<p align='center'>
236+
<img src='./image/Screenshots/iPhone/iPhone 1.png'>
237+
</p>
238+
239+
<p align='center'>
240+
<img src='./image/Screenshots/iPhone/iPhone 2.png'>
241+
</p>
242+
243+
<p align='center'>
244+
<img src='./image/Screenshots/iPhone/iPhone 3.png'>
245+
</p>
246+
247+
<p align='center'>
248+
<img src='./image/Screenshots/iPad/iPad 1.png'>
249+
</p>
250+
251+
<p align='center'>
252+
<img src='./image/Screenshots/iPad/iPad 2.png'>
253+
</p>
254+
255+
<p align='center'>
256+
<img src='./image/Screenshots/iPad/iPad 3.png'>
257+
</p>
258+
259+
260+
# 🌈功能展示
261+
262+
用 Vue.js 搭建一个 Web 页面很快。
263+
264+
<p align='center'>
265+
<img src='./image/Gifs/Web.gif'>
266+
</p>
267+
268+
269+
看看 Vuex 管理状态的方便。登录状态保存在 state 里面，全局都会获取到。
270+
271+
<p align='center'>
272+
<img src='./image/Gifs/Web-login.gif'>
273+
</p>
274+
275+
一旦用户没有登录，点击购买电子书的时候，判断没有用户登录都会跳转到登录页面。
276+
277+
还有一点值得说的是，由于这是一个 SPA ，所以里面的路由都用 Router-link 实现的，而没有选用 a 标签的跳转，效果就是跳转并不用去请求数据，秒跳。这个用户体验真的很爽。
278+
279+
\<router\-link\> 比起写死的 \<a href="..."\> 会好一些，理由如下：
280+
281+
无论是 HTML5 history 模式还是 hash 模式，它的表现行为一致，所以，当你要切换路由模式，或者在 IE9 降级使用 hash 模式，无须作任何变动。
282+
283+
在 HTML5 history 模式下，router-link 会拦截点击事件，让浏览器不再重新加载页面。
284+
285+
当你在 HTML5 history 模式下使用 base 选项之后，所有的 to 属性都不需要写（基路径）了。
286+
287+
288+
<p align='center'>
289+
<img src='./image/Gifs/Web-logout.gif'>
290+
</p>
291+
292+
登出页面同理，一旦用户登出，所有显示用户名的地方都会变成登录，navigationBar 上的购物车也一并消失。用 Vuex 管理状态，挺好的。
293+
294+
295+
<p align='center'>
296+
<img src='./image/Gifs/Web-email.gif'>
297+
</p>
298+
299+
这就是 email 的表单验证了，没有太多的技术含量。
300+
301+
302+
<p align='center'>
303+
<img src='./image/Gifs/Web-buy.gif'>
304+
</p>
305+
306+
307+
这里是购物车页面，这里用到了 MVVM 页面的绑定的思想，页面上4个按钮，点任意一个按钮都会立即改变下面的总价。关于 Vue.js 的 MVVM 实现思想值得 iOSer 们学习。
308+
309+
接下来这个是 iPhone 的 Safari 上的表现，速度还可以。
310+
311+
<p align='center'>
312+
<img src='./image/Gifs/Web-iPhone.gif'>
313+
</p>
314+
315+
316+
在跨平台的这几个应用中，体验最好的，我觉得还是 Mac 的应用。使用起来满意度非常高。
317+
318+
<p align='center'>
319+
<img src='./image/Gifs/Web-Mac.gif'>
320+
</p>
321+
322+
最后就是 Cordova 框架搭建的 手机 app，体验度不高，具体如何，看图吧，总之不优化的 Cordova ，对于挑剔的我来说，我是不满意的。
323+
324+
iPhone 上的应用
325+
326+
<p align='center'>
327+
<img src='./image/Gifs/Web-iPone app.gif'>
328+
</p>
329+
330+
iPad 上的应用
331+
332+
<p align='center'>
333+
<img src='./image/Gifs/Web-iPad app.gif'>
334+
</p>
335+
336+
337+
# 🤔项目完成之后的感想
338+
339+
先安利一下 element-ui 这个项目，用它来搭建项目，真的很快，页面很快就可以搭建完成，开发 Vue.js 的同学一定有听过这个库。节约出来的大把时间可以把更多的精力放在业务开发上面。
340+
341+
大家都在说现在是大前端时代，移动开发和前端融合是必然。但是两个平台的开发其实还是有很多的不同，我在经历过前端的开发和 iOS 开发以后，感想还是很多的，前端和 iOS 是有很多可以相互学习的地方，两者也各有优缺点。接下来我打算写写这些方面的系列文章。前端的工程化，组件化，路由，MVVM，分别和 iOS 这边各有哪些优缺点，相互可以学习些什么。（感觉给自己挖了一个大坑）
342+
343+
344+
# 📜Feature
345+
346+
347+
有时间就支持 Weex ，把这个 Vue.js 的改成一个完整的 Weex 的应用，变成原生以后，性能一定不会差。这样跨平台开发就应该全了。
348+
58349

59350

60351
# ❗️勘误
61352

62-
+ 如果在文章中发现了问题，欢迎提交 PR 或者 issue，欢迎大神们多多指点🙏🙏🙏
353+
354+
如果在项目中发现了有什么不解或者发现了 bug，欢迎提交 PR 或者 issue，欢迎大神们多多指点小弟🙏🙏🙏
63355

64356

65357

66358
# ♥️感谢
67359

68-
感谢Star！
360+
361+
如果喜欢这个项目，欢迎Star！
69362

70363

71364

72365
------
73366

74-
# LICENSE
367+
# 🌏LICENSE
75368

76369
GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007
77370

‎image/Gifs/Web-Mac.gif

Copy file name to clipboard
7.63 MB
Loading

‎image/Gifs/Web-buy.gif

Copy file name to clipboard
4.66 MB
Loading

‎image/Gifs/Web-email.gif

Copy file name to clipboard
616 KB
Loading

‎image/Gifs/Web-iPad app.gif

Copy file name to clipboard
13.2 MB
Loading

‎image/Gifs/Web-iPhone.gif

Copy file name to clipboard
7.66 MB
Loading

‎image/Gifs/Web-iPone app.gif

Copy file name to clipboard
6.69 MB
Loading

‎image/Gifs/Web-login.gif

Copy file name to clipboard
2.17 MB
Loading

‎image/Gifs/Web-logout.gif

Copy file name to clipboard
647 KB
Loading

‎image/Gifs/Web.gif

Copy file name to clipboard
12.1 MB
Loading

‎image/Screenshots/Mac/Mac 1.png

Copy file name to clipboard
193 KB
Loading

‎image/Screenshots/Mac/Mac 2.png

Copy file name to clipboard
215 KB
Loading

‎image/Screenshots/Mac/Mac 3.png

Copy file name to clipboard
304 KB
Loading

‎image/Screenshots/Mac/Mac 4.png

Copy file name to clipboard
183 KB
Loading

‎image/Screenshots/Web/Nexus 5x Web.png

Copy file name to clipboard
82.4 KB
Loading

‎image/Screenshots/Web/Nexus 6P Web.png

Copy file name to clipboard
99.9 KB
Loading

‎image/Screenshots/Web/Web 1.png

Copy file name to clipboard
218 KB
Loading

‎image/Screenshots/Web/Web 2.png

Copy file name to clipboard
236 KB
Loading

‎image/Screenshots/Web/Web 3.png

Copy file name to clipboard
219 KB
Loading

‎image/Screenshots/Web/Web 4.png

Copy file name to clipboard
96.1 KB
Loading

‎image/Screenshots/Web/Web 5.png

Copy file name to clipboard
267 KB
Loading

‎image/Screenshots/Web/iPad Web.png

Copy file name to clipboard
143 KB
Loading

‎image/Screenshots/Web/iPhone 5 Web.png

Copy file name to clipboard
65.1 KB
Loading

‎image/Screenshots/Web/iPhone 7 Plus Web.png

Copy file name to clipboard
96.4 KB
Loading

‎image/Screenshots/Web/iPhone 7 Web.png

Copy file name to clipboard
89.6 KB
Loading

‎image/Screenshots/iPad/iPad 1.png

Copy file name to clipboard
152 KB
Loading

‎image/Screenshots/iPad/iPad 2.png

Copy file name to clipboard
218 KB
Loading

‎image/Screenshots/iPad/iPad 3.png

Copy file name to clipboard
246 KB
Loading

‎image/Screenshots/iPhone/iPhone 1.png

Copy file name to clipboard
85.9 KB
Loading

‎image/Screenshots/iPhone/iPhone 2.png

Copy file name to clipboard
110 KB
Loading

‎image/Screenshots/iPhone/iPhone 3.png

Copy file name to clipboard
74.7 KB
Loading

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.