:軟件需求文檔格式的標(biāo)準(zhǔn)寫法 1.引言 1.1 編寫目的 · 闡明開發(fā)本軟件的目的; 1.2 項(xiàng)目背景 · 標(biāo)識(shí)待開發(fā)軟件產(chǎn)品的名稱、代碼; · 列出本項(xiàng)目的任務(wù)提出者、項(xiàng)目負(fù)責(zé)人、系統(tǒng)分析員、系統(tǒng)設(shè)計(jì)員、程序設(shè)計(jì)員、程序員、資料員以及與本項(xiàng)目開展
創(chuàng)新互聯(lián)成立與2013年,先為惠民等服務(wù)建站,惠民等地企業(yè),進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為惠民企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問(wèn)題。
過(guò)Apple的文檔也有它獨(dú)有的好處,比如絕大部分的文檔都有相應(yīng)的PDF格式文件提供下載,對(duì)于離線閱讀十分的方便,而且還可以在PDF做一些相應(yīng)的筆記,針對(duì)某幾頁(yè)進(jìn)行打印等等。
另外,Apple還會(huì)給出該API所對(duì)應(yīng)的框架結(jié)構(gòu)使用的文檔,其中會(huì)有一些代碼例子。但是其實(shí)那些例子依然不夠,還是需要到其它地方尋找。但是這些講述結(jié)構(gòu)的文檔卻是體現(xiàn)出API設(shè)計(jì)的來(lái)源,所以十分值得閱讀,只是需要花時(shí)間了理解和消化。
在此,我簡(jiǎn)單文類羅列了一些我在學(xué)習(xí)和搜索的過(guò)程中看到的那些Apple官方的iOS開發(fā)相關(guān)的文檔資料。其中粗體顯示的文檔,是我個(gè)人覺(jué)得比較有用的部分
如果你用的是mac,下載一個(gè) xcode 下,它包含了ios iWatch mac 的開發(fā)sdk,,直接看就可以了,如果不是,登錄 develop.apple.com 看也是可以的!
開發(fā)文檔主要要寫清楚一下的五個(gè)方面:
1 開發(fā)環(huán)境及工具
2 模塊關(guān)系
3 項(xiàng)目進(jìn)度
4 難點(diǎn)預(yù)估
5 功能與所計(jì)劃采用的技術(shù)
1.預(yù)先準(zhǔn)備在你開始將程序提交到App Store之前,你需要有一個(gè)App ID,一個(gè)有效的發(fā)布證書,以及一個(gè)有效的Provisioning profile。下面來(lái)看看它們各自的作用。Step 1: App ID(應(yīng)用ID)App ID是識(shí)別不同應(yīng)用程序的唯一標(biāo)示符。每個(gè)app都需要一個(gè)App ID或者app標(biāo)識(shí)。目前有兩種類型的App標(biāo)識(shí):一個(gè)是精確的App ID( explicit App ID),一個(gè)是通配符App ID( wildcard App ID)。使用通配符的App ID可以用來(lái)構(gòu)建和安裝多個(gè)程序。盡管通配符App ID非常方便,但是一個(gè)精確的App ID也是需要的,尤其是當(dāng)App使用iCloud 或者使用其他iOS功能的時(shí)候,比如Game Center、Push Notifications或者IAP。 如果你不確定什么樣的App ID適合你的項(xiàng)目,我推薦你讀下蘋果關(guān)于這一主題的文檔: Technical Note QA1713。 Step 2: Distribution Certificate(發(fā)布證書) iOS應(yīng)用都有一個(gè)安全證書用于驗(yàn)證開發(fā)者身份和簽名。為了可以向App Store提交app,你需要?jiǎng)?chuàng)建一個(gè)iOS provisioning profile 。首先需要?jiǎng)?chuàng)建一個(gè)distribution certificate(發(fā)布證書),過(guò)程類似于創(chuàng)建一個(gè)development certificate(開發(fā)證書)。如果你已經(jīng)在實(shí)體設(shè)備上測(cè)試你的App,那么你對(duì)創(chuàng)建development certificate就已經(jīng)很熟悉了。 如果對(duì)此不熟悉,我建議你讀下 蘋果關(guān)于signing certificates和provisioning profiles的詳細(xì)指導(dǎo) 。 Step 3: Provisioning Profile(配置文件) 一旦你創(chuàng)建了App ID和distribution certificate,你可以創(chuàng)建一個(gè)iOS provisioning profile以方便在App Store中銷售你的App。不過(guò),你不能使用和ad hoc distribution相同的provisioning profile。你需要為App Store分銷創(chuàng)建一個(gè)單獨(dú)的provisioning profile,如果你使用通配符App ID,那么你的多個(gè)app就可以使用相同的provisioning profile。 Step 4: Build Settings(生成設(shè)置)配置App ID、distribution certificate 和provisioning profile已經(jīng)完成,是時(shí)候配置Xcode中target的build settings了。在Xcode Project Navigator的targets列表中選擇一個(gè)target,打開頂部的 Build Settings選項(xiàng),然后更新一下 Code Signing來(lái)跟之前創(chuàng)建的distribution provisioning profile相匹配。最近添加的provisioning profiles有時(shí)候不會(huì)立馬就在build settings的 Code Signing中看到,重啟一下Xcode就可以解決這個(gè)問(wèn)題。 配置Target的Build SettingsStep 5: Deployment Target(部署目標(biāo))非常有必要說(shuō)下deployment target,Xcode中每個(gè)target都有一個(gè)deployment target,它可以指出app可以運(yùn)行的最小版本。不過(guò),一旦應(yīng)用在App Store中生效,再去修改deployment target,你要考慮到一定后果。如果你在更新app的時(shí)候提高了deployment target,但是已經(jīng)購(gòu)買應(yīng)用的用戶并沒(méi)有遇到新的deployment target,那么應(yīng)用就不能在用戶的移動(dòng)設(shè)備上運(yùn)行。如果用戶通過(guò)iTunes (不是設(shè)備)下載了一個(gè)更新過(guò)的app,然后替代了設(shè)備上原先的版本,最后卻發(fā)現(xiàn)新版本不能在設(shè)備上運(yùn)行,這確實(shí)是個(gè)問(wèn)題。(1) 當(dāng)你決定提高現(xiàn)有app的deployment target時(shí),要在新版本的版本注釋中進(jìn)行說(shuō)明。如果你提前告知用戶,那么至少有一點(diǎn),你已經(jīng)盡力阻止問(wèn)題的發(fā)生了。(2) 對(duì)于一款新app,我經(jīng)常會(huì)把deployment target設(shè)置為最近發(fā)布的系統(tǒng)版 本。因?yàn)樾耰OS版本發(fā)布后,滲透率的增長(zhǎng)速度是令人難以置信的。很多人認(rèn)為提高deployment target會(huì)失去大部分市場(chǎng),這個(gè)說(shuō)法并不準(zhǔn)確,比如iOS 6, iOS 6發(fā)布后一個(gè)月,超過(guò)60%的設(shè)備已經(jīng)進(jìn)行了更新 。但對(duì)Android而言,就是另外一回事了, Android用戶并不會(huì)像iOS用戶那樣熱衷于更新操作系統(tǒng)版本 。 【以上簡(jiǎn)而言之,最好從項(xiàng)目設(shè)計(jì)時(shí),就決定是否考慮兼容低版本用戶,支持的話,寫代碼時(shí)使用ios新特性時(shí)最好做一下判斷,if是老版本if是新版本】在最新的WWDC2014上,公布的數(shù)字顯示,iOS7的市場(chǎng)占有率已經(jīng)為87%2. Assets(資源包)Step 1: Icons(圖標(biāo))Icon是App中不可分割的一部分,你要確保icon尺寸不會(huì)出現(xiàn)差錯(cuò)。iTunes Artwork: 1024px x 1024px (required)iPad/iPad Mini: 72px x 72px and 114px x 114px (required) iPhone/iPod Touch: 57px x 57px and 114px x 114px (required) 120px x 120px(required) for iPhone5/iPhone5c/iPhone5sSearch Icon: 29px x 29px and 58px x 58px (optional) Settings Application: 50px x 50px and 100px x 100px (optional) Step 2: 屏幕截圖屏幕截圖的作用不言而喻,你可以為每個(gè)app上傳5張截圖,雖然至少需要上傳一張,可能很少有人會(huì)只上傳一張圖片。另外,你還需要分別為 iPhone/iPod Touch和iPad/iPad Mini準(zhǔn)備不同的屏幕截圖。這也是不小的工作量,但卻能展示應(yīng)用的另一面。Shiny Development開發(fā)的一款售價(jià)6.99美元的Mac軟件 Status Magic可以為你節(jié)省不少時(shí)間。Status Magic可以幫你把狀態(tài)欄放在截圖的正確位置。 屏幕截圖和icon是應(yīng)用給用戶的第一感覺(jué),直接關(guān)系到用戶會(huì)不會(huì)購(gòu)買。不過(guò),你所上傳的屏幕截圖也不一定非得是實(shí)際的截圖,看看 Where’s My Water? 截圖可以通過(guò)使用此策略,更具吸引力和說(shuō)服力。當(dāng)我們連上調(diào)試機(jī)以后??梢岳肵code中Organizer中的New Screenshot輕松的截出標(biāo)準(zhǔn)大小的圖片。Step 3: 元數(shù)據(jù) 在提交應(yīng)用之前,要管理好app的元數(shù)據(jù),包括1應(yīng)用名稱、2版本號(hào)、3主要類別,4簡(jiǎn)潔的描述,5關(guān)鍵詞,6.支持URL。如果你需要更新應(yīng)用,你還要提供新增加的版本內(nèi)容。 如果你的應(yīng)用需要注冊(cè)【打開APP需要登錄,比如飛信】,你還得向蘋果提供一個(gè)測(cè)試賬戶或者demo賬戶,這樣審核人員就能很快進(jìn)入app,而不用再注冊(cè)賬號(hào)。3. 提交準(zhǔn)備Xcode 4以后,開發(fā)者提交應(yīng)用的過(guò)程就簡(jiǎn)單多了,可以直接使用Xcode進(jìn)行提交。首先在 iTunes Connect中創(chuàng)建app,訪問(wèn)iTunes Connect,使用你的iOS開發(fā)者賬號(hào)登陸,點(diǎn)擊右邊的“Manage Your Apps”,點(diǎn)擊左上角的“Add New App”,選擇“iOS App”,然后完成表格。