0.序

玩陰陽(yáng)師的肝帝們都知道，每天早上5點(diǎn)和下午6點(diǎn)會(huì)刷新兩次封印任務(wù)，每次做任務(wù)時(shí)最蛋疼的就是找各種怪物對(duì)應(yīng)的副本以及神秘線索。 陰陽(yáng)師提供了 網(wǎng)易精靈 可以進(jìn)行一些數(shù)據(jù)查詢(xún)，但體驗(yàn)實(shí)在太感人，所以大多數(shù)人選擇使用搜素引擎搜索怪物分布及神秘線索。

而每次使用搜索引擎查找又十分不方便，所以筆者決定寫(xiě)一個(gè)查詢(xún)陰陽(yáng)師妖怪分布的小程序，力求做到使用快捷體驗(yàn)更快捷，把更多的時(shí)間留給狗糧和御魂。

恰好上周末有兩天時(shí)間，所以立馬開(kāi)寫(xiě)。

1.構(gòu)思與設(shè)計(jì) ( 3小時(shí) )

1.1 構(gòu)思

1. 要做的小程序主要功能就是查詢(xún)功能，所以主頁(yè)應(yīng)該像搜索引擎一樣簡(jiǎn)潔，搜索框是肯定需要的；
2. 主頁(yè)包含熱門(mén)搜索，緩存最熱式神的搜索；
3. 搜索支持完整匹配或者單字匹配；
4. 點(diǎn)擊搜索結(jié)果直接跳轉(zhuǎn)到式神詳情頁(yè)；53. 式神詳情頁(yè)應(yīng)該包含式神的圖鑒、名稱(chēng)、稀有度、出沒(méi)地點(diǎn)，并且出沒(méi)地點(diǎn)按妖怪?jǐn)?shù)量從多到少排序；
5. 加入數(shù)據(jù)報(bào)錯(cuò)及提建議的功能；
6. 支持用戶個(gè)人的搜索歷史；
7. 小程序的名字，綜合考慮小程序的功能最后決定叫做 式神獵手 ( 其實(shí)這是最后開(kāi)發(fā)完成后才想好的 )；

1.2 設(shè)計(jì)

構(gòu)思好后筆者就開(kāi)始用筆者半吊子的 PS 水平設(shè)計(jì)了下草圖，大概是這個(gè)樣子：

嗯，最主要的首頁(yè)和詳情頁(yè)設(shè)計(jì)好就行，然后就可以開(kāi)始具體考慮怎么做了！

1.3 技術(shù)架構(gòu)

1. 前端毫無(wú)疑問(wèn)就是微信小程序咯；
2. 后端使用 Django 提供 Restful API 服務(wù)；
3. 當(dāng)前最熱搜索用 redis 做緩存服務(wù)器進(jìn)行緩存；
4. 個(gè)人搜索記錄就使用微信小程序提供的 localstorage ;
5. 式神分布信息使用爬蟲(chóng)爬取清洗，格式化為 json , 入庫(kù)前再做人工檢查；
6. 式神圖片及圖標(biāo)直接爬取官方資料；
7. 自己制作爬不到的式神圖片及圖標(biāo)；
8. 小程序要求 HTTPS 連接，恰好筆者之前搞過(guò)，可以直接看這里 HTTPS 免費(fèi)部署指南

到此，正式開(kāi)發(fā)前的準(zhǔn)備得當(dāng)后，我們就可以開(kāi)始正式開(kāi)發(fā)了

2. API 服務(wù)開(kāi)發(fā) ( 5小時(shí) )

Django 的 API 服務(wù)開(kāi)發(fā)筆者之前經(jīng)常做，所以有比較完整的解決方案，可以參考這里django-simple-serializer

之所以花了 5 個(gè)小時(shí)是因?yàn)榻?4 個(gè)小時(shí)在增加 django-simple-serializer 對(duì) Django ManyToManyField 中 through 特性的支持。

簡(jiǎn)而言之， through 特性就是可以使多對(duì)多關(guān)系的中間表增添一些額外的字段或?qū)傩裕? 怪物副本和怪物之間的多對(duì)多關(guān)系就需要增加一個(gè)儲(chǔ)存每個(gè)副本有多少只相應(yīng)怪物數(shù)量的字段 count。

搞定 through 支持后 API 的構(gòu)建就很快啦，主要有五個(gè) API ：

1. 搜索接口；
2. 式神詳情接口；
3. 式神副本接口；
4. 熱門(mén)搜索接口；
5. 反饋接口；

寫(xiě)好接口后添加一些 mock data 以供測(cè)試；

3. 前端開(kāi)發(fā) ( 8小時(shí) )

前端花了最久的時(shí)間。

一方面筆者真的是個(gè)后端工程師，前端屬于半路出家，另一方面小程序有一些坑。 當(dāng)然，最主要的是一直在調(diào)整界面效果，這里花了大量時(shí)間。

寫(xiě)小程序的整體體驗(yàn)筆者感覺(jué)就和寫(xiě) vue.js 一摸一樣，只不過(guò)一些 html 標(biāo)簽沒(méi)辦法使用，而是需要按小程序官方提供的組件進(jìn)行書(shū)寫(xiě)， 這里有一點(diǎn)感受就是，小程序本身組件化的設(shè)計(jì)思路應(yīng)該是借鑒了 React 而語(yǔ)法之類(lèi)的應(yīng)該是借鑒了 vue.js 。

最后前端開(kāi)發(fā)完畢后主要分為這幾個(gè)頁(yè)面：

1. 主頁(yè) （ 搜索頁(yè) ）；
2. 式神詳情頁(yè)；
3. 我的頁(yè)面 （ 主要是放搜索歷史和免責(zé)申明等等東西 ）；
4. 反饋界面；
5. 聲明界面 （ 為何需要這個(gè)界面？ 因?yàn)樗袌D片及一些資源都是直接抓取陰陽(yáng)師官方的資源，所以這里需要申明只是非盈利性質(zhì)的使用，版權(quán)亂七八糟的都還是陰陽(yáng)師的 ）。

哎，丑媳婦早晚要見(jiàn)公婆，這里不得不放最后開(kāi)發(fā)出來(lái)的界面圖了

對(duì)于微信小程序的入門(mén)及基礎(chǔ)，筆者就不在這里多講了，相信到現(xiàn)在對(duì)微信小程序有關(guān)注的開(kāi)發(fā)者或多或少自己寫(xiě)個(gè)簡(jiǎn)單的 demo 肯定是沒(méi)問(wèn)題的，我就主要講一講我在開(kāi)發(fā)中遇到的坑：

3.1 background-image 屬性

在寫(xiě)式神詳情頁(yè)的時(shí)候兩個(gè)地方需要用到 background-image 屬性設(shè)置背景圖，在微信開(kāi)發(fā)者工具中一切顯示正常，但一到真機(jī)調(diào)試就沒(méi)有辦法顯示，最后發(fā)現(xiàn)小程序的 background-image 在真機(jī)不支持引用本地資源，解決方案有兩種：

1. 使用網(wǎng)絡(luò)圖片： 考慮到背景圖的大小，筆者放棄了這種方案；
2. 使用 base64 編碼圖片。

正常來(lái)講，css 中的 background-image 就支持 base64 ，這種方案相當(dāng)于把圖片直接用 base64 編碼成一段 base64 碼進(jìn)行儲(chǔ)存，在使用時(shí)這樣使用即可：

background-image: url(data:image/image-format;base64,XXXX);

image-format 為圖片本身的格式，而 xxxx 就是圖片經(jīng)過(guò) base64 后得到的編碼。這種方式其實(shí)是一種變相引用本地資源的方式，好處在于可以減少請(qǐng)求圖片的次數(shù)，而缺點(diǎn)則是會(huì)增大 css 文件并使其不是那么好看。

最后筆者選擇第二種方式主要還是考慮到圖片的大小以及 wxss 的增大在可接受范圍內(nèi)。

3.2 template

小程序支持模版，但要注意模板擁有自己的作用域，只能使用data傳入的數(shù)據(jù)。

另外，在傳入數(shù)據(jù)時(shí)需要將相關(guān)數(shù)據(jù)解構(gòu)傳入，在模版內(nèi)部是直接以 {{ xxxx }} 的形式進(jìn)行訪問(wèn)，而不是像在循環(huán)中 {{ item.xxx }} 這種訪問(wèn)形式；

關(guān)于解構(gòu)：

<template is="xxx" data="{{...object}}"/>

三個(gè) . 就是解構(gòu)操作；

一般 template 都會(huì)放在 單獨(dú)的 template 文件中讓其他文件進(jìn)行調(diào)用，而不會(huì)直接寫(xiě)在正常的 wxml 中。 比如筆者目錄大概是這樣的：

├── app.js
├── app.json
├── app.wxss
├── pages
│   ├── feedback
│   ├── index
│   ├── my
│   ├── onmyoji
│   ├── statement
│   └── template
│       ├── template.js
│       ├── template.json
│       ├── template.wxml
│       └── template.wxss
├── static
└── utils

關(guān)于其他文件調(diào)用 template，直接使用 import 即可：

<import src="../template/template.wxml" />

然后在需要引用模版的地方：

<template is="xxx" data="{{...object}}"/>
<!--is 后填寫(xiě)模版名稱(chēng)-->

這里遇到另一個(gè)問(wèn)題，template 對(duì)應(yīng)的樣式寫(xiě)在 template 對(duì)應(yīng)的 wxss 中并沒(méi)有作用，需要寫(xiě)在調(diào)用 template 的文件的 wxss 中，比如 index 需要使用 template 則需要將對(duì)應(yīng)的 css 寫(xiě)在 my/my.wxss 中。

4. 爬取圖片資源 ( 2小時(shí) )

式神的圖標(biāo)及形象圖基本上陰陽(yáng)師官網(wǎng)都有，這里自己做也不現(xiàn)實(shí)，所以果斷寫(xiě)爬蟲(chóng)爬下來(lái)然后存到自己的 cdn 。

大圖和小圖都在 http://yys.163.com/shishen/index.html 這里可以找到。 一開(kāi)始考慮爬取網(wǎng)頁(yè)然后 beautiful soup 提取數(shù)據(jù)，后面發(fā)現(xiàn)式神數(shù)據(jù)竟然是異步加載的，那就更簡(jiǎn)單了，分析網(wǎng)頁(yè)得到 https://g37simulator.webapp.163.com/get_heroid_list 直接返回了式神信息的 json 信息，所以很容易寫(xiě)個(gè)爬蟲(chóng)就可以搞定了：

# coding: utf-8
import json
import requests
import urllib
from xpinyin import Pinyin

url = "https://g37simulator.webapp.163.com/get_heroid_list?callback=jQuery11130959811888616583_1487429691764&rarity=0&page=1&per_page=200&_=1487429691765"
result = requests.get(url).content.replace('jQuery11130959811888616583_1487429691764(', '').replace(')', '')
json_data = json.loads(result)
hellspawn_list = json_data['data']
p = Pinyin()
for k, v in hellspawn_list.iteritems():
    file_name = p.get_pinyin(v.get('name'), '')
    print 'id: {0} name: {1}'.format(k, v.get('name'))
    big_url = "https://yys.res.netease.com/pc/zt/20161108171335/data/shishen_big/{0}.png".format(k)
    urllib.urlretrieve(big_url, filename='big/{0}@big.png'.format(file_name))
    avatar_url = "https://yys.res.netease.com/pc/gw/20160929201016/data/shishen/{0}.png".format(k)
    urllib.urlretrieve(avatar_url, filename='icon/{0}@icon.png'.format(file_name))

然而，爬完數(shù)據(jù)后發(fā)現(xiàn)一個(gè)問(wèn)題，網(wǎng)易官方的圖片都是無(wú)碼高清大圖，對(duì)于筆者這種窮 ds 大圖放在 cdn 上兩天就得破產(chǎn)，所以需要批量將圖片轉(zhuǎn)成既不太大又能看的過(guò)去。嗯，這里就可以用到 ps 的批處理能力了。

1. 打開(kāi) ps ，然后選擇爬到的一張圖片；
2. 選擇菜單欄上的“窗口”然后選擇“動(dòng)作；
3. 在“動(dòng)作”選項(xiàng)下，新建一個(gè)動(dòng)作；
4. 點(diǎn)擊圓形錄制按鈕開(kāi)始錄制動(dòng)作；
5. 按正常處理圖片等順序?qū)⒁粡垐D片存為 web 格式；
6. 點(diǎn)擊方形停止按鈕停止錄制動(dòng)作；
7. 選擇菜單欄上的 文件－自動(dòng)－批處理－選擇之前錄制的動(dòng)作－配置好輸入文件夾和輸出文件夾；
8. 點(diǎn)擊確定就可以啦；

等批處理結(jié)束，期間刷個(gè)御魂啥的應(yīng)該就好了，然后將得到的所有圖片上傳到靜態(tài)資源服務(wù)器，圖片這里就處理完啦。

5. 式神數(shù)據(jù)爬取 ( 4小時(shí) )

式神分布數(shù)據(jù)網(wǎng)上比較雜并且數(shù)據(jù)很多有偏差，所以斟酌再三決定采用半人工半自動(dòng)的方式，爬到的數(shù)據(jù)輸出為 json：

{
    "scene_name": "探索第一章",
    "team_list": [{
        "name": "天邪鬼綠1",
        "index": 1,
        "monsters": [{
            "name": "天邪鬼綠",
            "count": 1
            },{
            "name": "提燈小僧",
            "count": 2
            }]
        },{
        "name": "天邪鬼綠2",
        "index": 2,
        "monsters": [{
            "name": "天邪鬼綠",
            "count": 1
            },{
            "name": "提燈小僧",
            "count": 2
            }]
        },{
        "name": "提燈小僧1",
        "index": 3,
        "monsters": [{
            "name": "天邪鬼綠",
            "count": 2
            },{
            "name": "提燈小僧",
            "count": 1
            }]
        },{
        "name": "提燈小僧2",
        "index": 4,
        "monsters": [{
            "name": "燈籠鬼",
            "count": 2
            },{
            "name": "提燈小僧",
            "count": 1
            }]
        },{
        "name": "首領(lǐng)",
        "index": 5,
        "monsters": [{
            "name": "九命貓",
            "count": 3
            }]
        }]
}

然后再人工檢查一遍，當(dāng)然還是會(huì)有遺漏，所以數(shù)據(jù)報(bào)錯(cuò)的功能就很重要啦。

這一部分實(shí)際寫(xiě)代碼的時(shí)間可能只有半個(gè)多小時(shí)，剩下時(shí)間一直在檢查數(shù)據(jù)；

一切檢查結(jié)束后寫(xiě)個(gè)腳本直接將 json 導(dǎo)入到數(shù)據(jù)庫(kù)中，檢查無(wú)誤后用 fabric 發(fā)布到線上服務(wù)器進(jìn)行測(cè)試；

6. 測(cè)試 ( 2小時(shí) )

最后一步基本上就是在手機(jī)上體驗(yàn)查錯(cuò)，修改一些效果，關(guān)閉調(diào)試模式準(zhǔn)備提交審核；

此時(shí)已經(jīng)是周日，哦，不對(duì)，應(yīng)該是周一早上一點(diǎn)鐘了：

不得不說(shuō)，小程序團(tuán)隊(duì)審核速度很快啊，周一下午就審核通過(guò)了，然后果斷上線。

最后放效果圖：

感興趣的同學(xué)歡迎掃碼體驗(yàn)喲：

手機(jī)長(zhǎng)按不能進(jìn)入小程序，需要在 微信-發(fā)現(xiàn)-小程序-搜索-式神獵手 進(jìn)入

7. 結(jié)尾

以上所有內(nèi)容均已開(kāi)源，歡迎大家參考：

后端： 式神獵手后端 ( https://github.com/bluedazzle/HellspawnHunterBackend )
小程序端： 式神獵手小程序 ( https://github.com/bluedazzle/hellspawn-hunter-weapp )
API 解決方案： django-simple-serializer ( https://github.com/bluedazzle/django-simple-serializer )