一：項(xiàng)目結(jié)構(gòu)

微信小程序項(xiàng)目結(jié)構(gòu)主要有四個(gè)文件類型,如下

WXML （WeiXin Markup Language）是框架設(shè)計(jì)的一套標(biāo)簽語(yǔ)言，結(jié)合基礎(chǔ)組件、事件系統(tǒng)，可以構(gòu)建出頁(yè)面的結(jié)構(gòu)。內(nèi)部主要是微信自己定義的一套組件。

WXSS (WeiXin Style Sheets)是一套樣式語(yǔ)言，用于描述 WXML 的組件樣式，

js 邏輯處理，網(wǎng)絡(luò)請(qǐng)求

json 小程序設(shè)置，如頁(yè)面注冊(cè)，頁(yè)面標(biāo)題及tabBar。

注意：為了方便開(kāi)發(fā)者減少配置項(xiàng)，規(guī)定描述頁(yè)面的這四個(gè)文件必須具有相同的路徑與文件名。

在根目錄下用app來(lái)命名的這四中類型的文件，就是程序入口文件。

app.json

必須要有這個(gè)文件，如果沒(méi)有這個(gè)文件，項(xiàng)目無(wú)法運(yùn)行，因?yàn)槲⑿趴蚣馨堰@個(gè)作為配置文件入口，整個(gè)小程序的全局配置。包括頁(yè)面注冊(cè)，網(wǎng)絡(luò)設(shè)置，以及小程序的window背景色，配置導(dǎo)航條樣式，配置默認(rèn)標(biāo)題。

app.js
必須要有這個(gè)文件，沒(méi)有也是會(huì)報(bào)錯(cuò)！但是這個(gè)文件創(chuàng)建一下就行 什么都不需要寫
以后我們可以在這個(gè)文件中監(jiān)聽(tīng)并處理小程序的生命周期函數(shù)、聲明全局變量。

app.wxss
全局配置的樣式文件，項(xiàng)目非必須。

知道小程序基本文件結(jié)構(gòu)，就可以開(kāi)始研究官方demo了，研究過(guò)程中如果有不明白的地方可以去官方文檔尋求答案，如果找不到答案或者有疑問(wèn)，可再此博客留言，相互交流。下面介紹下出現(xiàn)概率較高的幾個(gè)問(wèn)題。

二：常見(jiàn)問(wèn)題

rpx（responsive pixel）

微信小程序新定義了一個(gè)尺寸單位，可以適配不同分辨率的屏幕，它規(guī)定屏幕寬為750rpx，如在 iPhone6 上，屏幕寬度為375px，共有750個(gè)物理像素，則750rpx = 375px = 750物理像素，1rpx = 0.5px = 1物理像素。

這個(gè)項(xiàng)目我用的都是rpx尺寸單位，期間遇到一個(gè)很奇葩的問(wèn)題。在相鄰的兩條信息直接都會(huì)有一個(gè)分割線，我將線的高度都設(shè)置成1rpx,但是不有個(gè)別分割線是不顯示的，如下圖

看到?jīng)]在第一條和第二條直接并沒(méi)有現(xiàn)實(shí)這條線，但是其他的都展示了，分割線的屬性是一樣的，而且在不同的手機(jī)上（分辨率不同）不顯示的分割線也是不同的，有的分辨率好幾條分割線都不顯示，不知道這是模擬器的bug還是rpx的bug。最后分割線的高度尺寸單位使用了px,解決了這個(gè)問(wèn)題。

40013錯(cuò)誤

在微信小程序剛出來(lái)的時(shí)候如果輸入AppID提示這個(gè)信息就表示沒(méi)有破解，但是現(xiàn)在官方軟件更新可以選擇無(wú)AppID開(kāi)發(fā)，如下圖，我們之間選擇無(wú)AppID，即可解決此錯(cuò)誤。建議安裝官方開(kāi)發(fā)工具?？扇ゴ颂幷蚁螺d鏈接。

4058錯(cuò)誤

微信小程序創(chuàng)建項(xiàng)目時(shí)選擇無(wú)AppID，創(chuàng)建項(xiàng)目時(shí)會(huì)生成app.json，app.josn是程序啟動(dòng)最重要的文件，程序的頁(yè)面注冊(cè)，窗口設(shè)置，tab設(shè)置及網(wǎng)絡(luò)請(qǐng)求時(shí)間設(shè)置都是在此文件下的。如果你創(chuàng)建的項(xiàng)目目錄下沒(méi)有app.json文件就會(huì)報(bào)下面的錯(cuò)誤。

我們看到上面的錯(cuò)誤信息中有個(gè)數(shù)字-4058，這應(yīng)該是初入微信小程序遇到最多的錯(cuò)誤了，這種一般都是文件缺失，后面有個(gè)path，可以對(duì)著該路徑看看是否存在這個(gè)文件。造成這種錯(cuò)誤的原因一般都是創(chuàng)建項(xiàng)目選擇的目錄不正確，或者在app.json注冊(cè)了一個(gè)不存在的頁(yè)面。
當(dāng)然還有一種情況就是在app.json文件的pages注冊(cè)的頁(yè)面是沒(méi)有創(chuàng)建的，或者你刪除了某個(gè)頁(yè)面，但是沒(méi)有取消注冊(cè)也會(huì)是-4058錯(cuò)誤。

Page注冊(cè)錯(cuò)誤

這個(gè)錯(cuò)誤可能很容易理解，頁(yè)面注冊(cè)錯(cuò)誤。頁(yè)面是通過(guò)Page對(duì)象來(lái)渲染的，每個(gè)頁(yè)面對(duì)應(yīng)的js文件必須要?jiǎng)?chuàng)建page，最簡(jiǎn)單的方式就是在js文件下寫入Page({})，在page中有管理頁(yè)面渲染的生命周期，以及數(shù)據(jù)處理，事件都在這完成。這個(gè)錯(cuò)誤引起的原因一般都是剛創(chuàng)建頁(yè)面，js文件還有有處理或者忘了處理。所以要養(yǎng)成創(chuàng)建頁(yè)面的同時(shí)在js文件先創(chuàng)建Page的習(xí)慣.

Page route錯(cuò)誤

字面意思就是頁(yè)面路由錯(cuò)誤，在微信中有兩種路由方式一種是在wxml文件使用

如下代碼：
wxml文件：

js文件事件處理函數(shù)：
bindtap:function(event){
wx.navigateTo({
url: "search/search"
})
}
如果你這樣寫的話，恭喜你，你就會(huì)看到上面提示的錯(cuò)誤，這是因?yàn)橹貜?fù)調(diào)用路由引起的，處理方法就是刪除一個(gè)路由，刪除

<navigator url="search/search"><navigator url="search/search"><view class="serach_view_show" bindtap="bindtap"> 搜索</view></navigator></navigator>

這種也是不允許的，也就是說(shuō)

Do not have * handler in current page.

大概意思就是當(dāng)前頁(yè)面沒(méi)有此處理，讓確定是否已經(jīng)定義，還指出了錯(cuò)誤出現(xiàn)的可能位置pages/message/message,其實(shí)這種問(wèn)題出現(xiàn)一般就是我們?cè)趙xml定義了一些處理事件，但是在js文件中沒(méi)有實(shí)現(xiàn)這個(gè)時(shí)事件的處理方法，就會(huì)出現(xiàn)這個(gè)錯(cuò)誤。那么我們按提示在js文件加上事件處理，如下代碼，加上后就不會(huì)再有此錯(cuò)誤提示。

  bindtap:function(event){
    wx.navigateTo({
      url: "search/search"
    })
  },

tabBar設(shè)置不顯示

對(duì)于tabBar不顯示，原因有很多，查找這個(gè)錯(cuò)誤直接去app.json這個(gè)文件，最常見(jiàn)的也是剛學(xué)習(xí)微信小程序最容易犯的錯(cuò)誤無(wú)外乎下面幾種
注冊(cè)頁(yè)面即將頁(yè)面寫到app.json的pages字段中，如

 "pages":[    "pages/message/message",    "pages/contact/contact",    "pages/dynamic/dynamic",     "pages/dynamic/music/music",    "pages/index/index",    "pages/logs/logs"
  ]

tabBar寫法錯(cuò)誤導(dǎo)致的不顯示，將其中的大寫字母B寫成小寫，導(dǎo)致tabBar不顯示。
tabBar的list中沒(méi)有寫pagePath字段，或者pagePath中的頁(yè)面沒(méi)有注冊(cè)
tabBar的list的pagePath指定的頁(yè)面沒(méi)有寫在注冊(cè)頁(yè)面第一個(gè)。微信小程序的邏輯是"pages"中的第一個(gè)頁(yè)面是首頁(yè)，也就是程序啟動(dòng)后第一個(gè)顯示的頁(yè)面，如果tabBar的list的pagePath指定的頁(yè)面都不是pages的第一個(gè)，當(dāng)然也就不會(huì)電視tabBar了。
tabBar的數(shù)量低于兩項(xiàng)或者高于五項(xiàng)，微信官方中明確規(guī)定tabBar的至少兩項(xiàng)最多五項(xiàng)。超過(guò)或者少于都不會(huì)顯示tabBar。

navigationBarTitle顯示問(wèn)題

通過(guò)這個(gè)動(dòng)態(tài)圖你應(yīng)該發(fā)現(xiàn)問(wèn)題了，當(dāng)點(diǎn)擊音樂(lè)進(jìn)入音樂(lè)界面時(shí)，title先顯示了WeChatForQQ然后顯示的音樂(lè)，這個(gè)體驗(yàn)肯定是難以接受的，原因是音樂(lè)界面的title是在js文件中page的生命周期方法中設(shè)置的。
若你不了解生命周期，可以點(diǎn)擊查看
Page({
data:{
// text:"這是一個(gè)頁(yè)面"
},
onLoad:function(options){
// 頁(yè)面初始化 options為頁(yè)面跳轉(zhuǎn)所帶來(lái)的參數(shù)

  },
  onReady:function(){    // 頁(yè)面渲染完成
    //NavigationBarTitle如果此處和json文件都設(shè)置，最后展示此處的標(biāo)題欄wx.setNavigationBarTitle({
  title: '音樂(lè)'})
  },
  onShow:function(){    // 頁(yè)面顯示
  },
  onHide:function(){    // 頁(yè)面隱藏
  },
  onUnload:function(){    // 頁(yè)面關(guān)閉
  }
})

通過(guò)注釋你應(yīng)該明白了，設(shè)置標(biāo)題寫在了onReady方法中，也就是頁(yè)面已經(jīng)渲染完成了，在onReady之前顯示的title就是json文件（覆蓋關(guān)系，如果在子頁(yè)面json文件設(shè)置title會(huì)覆蓋app.json全局設(shè)置）中的title?？赡苣銜?huì)說(shuō)將wx.setNavigationBarTitle寫在onLoad函數(shù)中，不過(guò)如果這樣設(shè)置是不對(duì)的，因?yàn)閛nLoad執(zhí)行過(guò)后才渲染頁(yè)面，在渲染頁(yè)面時(shí)title會(huì)從json文件中讀取，導(dǎo)致onLoad設(shè)置的title會(huì)只在頁(yè)面渲染之前展示，之后就顯示json文件的tile，所以現(xiàn)在你應(yīng)該明白ttle設(shè)置最優(yōu)的地方就是給子文件寫一個(gè)json文件，在文件中寫入，如果想改變顏色直接在文件中添加就可以，該文件所寫的屬性值會(huì)覆蓋app.json中設(shè)置的值。
{
"navigationBarTitleText": "音樂(lè)"
}

wx.navigateTo無(wú)法打開(kāi)頁(yè)面

一個(gè)應(yīng)用同時(shí)只能打開(kāi)5個(gè)頁(yè)面，當(dāng)已經(jīng)打開(kāi)了5個(gè)頁(yè)面之后，wx.navigateTo不能正常打開(kāi)新頁(yè)面。請(qǐng)避免多層級(jí)的交互方式，或者使用wx.redirectTo

本地資源無(wú)法通過(guò) css 獲取

background-image：可以使用網(wǎng)絡(luò)圖片，或者 base64，或者使用標(biāo)簽

頁(yè)面間數(shù)據(jù)傳遞

微信小程序路由（頁(yè)面跳轉(zhuǎn)）是通過(guò)API wx.navigateTo或者wxml中

 <navigator url="/pages/dynamic/dynamic?title={{item.title}}&message={{item.message}}">
          <view class="item" >
             <view class="item-left">
                  <image src="{{item.url}}" class="image"/>
             </view>
             <view class="item-middle">
                  <view>
                       <text class="title">{{item.title}}</text>
                  </view>
                  <view>
                      <text class="message">{{item.message}}</text>
                  </view>
            </view>
            <view class="item_right">
                <view><text class="time">{{item.time}}</text></view>
                <view class="mark" wx:if="{{item.count>0}}"><text class="text">{{item.count}}</text></view>
            </view>
         </view>
         <view  class="line"></view>
       </navigator>

而數(shù)據(jù)接收是在js文件的page里接收的，page生命周期有一個(gè)onLoad函數(shù)，它就是做一些初始化數(shù)據(jù)的工作，onLoad函數(shù)有一個(gè)參數(shù)options，我們就可以通過(guò)key將數(shù)據(jù)獲取，如下

Page({
  data:{    // text:"這是一個(gè)頁(yè)面"
    isHiddenToast:true
  }
  onLoad:function(options){    // 頁(yè)面初始化 options為頁(yè)面跳轉(zhuǎn)所帶來(lái)的參數(shù)
    console.log(options.title)     console.log(options.message)

  },
  onReady:function(){    // 頁(yè)面渲染完成
  },
  onShow:function(){    // 頁(yè)面顯示
  },
  onHide:function(){    // 頁(yè)面隱藏
  },
  onUnload:function(){    // 頁(yè)面關(guān)閉
  },
  bindtap:function(event){
wx.navigateTo({
  url: "/pages/message/search/search"})
  },
})

這樣就實(shí)現(xiàn)了頁(yè)面間數(shù)據(jù)傳遞功能。