現(xiàn)狀
- 工具的版本是
0.6.4请敦，在終端輸入weex --version镐躲；輸出info 0.6.4 -
iOS SDK版本是0.8.0，現(xiàn)在網(wǎng)上的版本是0.10.2侍筛。在文件WXDefine.h中可以看到版本號信息萤皂。
incubator-weex - 業(yè)務(wù)文件還是
.we結(jié)尾的，用Python寫了些小工具匣椰，將編譯和上傳過程實現(xiàn)了一定程度的自動化 -
native層擴展了很多自定義的組件敌蚜，自定義的模塊，比如web窝爪、富文本等等 -
js層寫了很多的工具弛车，比如$pt表示iOS上的點
網(wǎng)絡(luò)和資源
這部分這次改動還是比較大的，0.8.0版本的無法加載本地圖片的問題這個版本改了蒲每，不過改的方式出乎意料
-
<image>組件仍然只有一個src屬性纷跛，沒有加載本地圖片的配置。 -
WXNetworkProtocol已經(jīng)廢棄邀杏，用WXResourceRequestHandler替代贫奠。__attribute__ ((deprecated("Use WXResourceRequestHandler instead"))) -
WXNetworkDefaultImpl被刪除 - 增加
WebSocket - 增加
WXResourcexxx文件，統(tǒng)一實現(xiàn)網(wǎng)絡(luò)加載和本地資源加載
typedef enum : NSUInteger {
WXResourceTypeMainBundle,
WXResourceTypeServiceBundle,
WXResourceTypeImage,
WXResourceTypeFont,
WXResourceTypeVideo,
WXResourceTypeLink,
WXResourceTypeOthers
} WXResourceType;
iOS SDK替換
通過官網(wǎng)去
GitHub下載最新的源碼
apache/incubator-weexSDK直接替換舊版本的望蜡，也就是路徑下的文件incubator-weex-master/ios/sdk/WeexSDK/
接入文件修改
- 接入文件需要修改兩個地方唤崭。第1個是
0.8.0版本的拼寫錯誤，環(huán)境的單詞少了一個字母n
//init sdk enviroment
[WXSDKEngine initSDKEnvironment]; // 0.8.0版本initSDKEnviroment脖律，少了一個字母n谢肾，這次改過來了
第2個地方是網(wǎng)絡(luò)的默認實現(xiàn)。當(dāng)然小泉，如果網(wǎng)絡(luò)部分自己實現(xiàn)芦疏，不用他提供的，這部分就不需要改微姊。
//網(wǎng)絡(luò)
[WXSDKEngine registerHandler:[WXResourceRequestHandlerDefaultImpl new] withProtocol:@protocol(WXResourceRequestHandler)];
// 0.8.0版本[WXSDKEngine registerHandler:[WXNetworkDefaultImpl new] withProtocol:@protocol(WXNetworkProtocol)];
舊版本中的修改遷移
有些我們認為是不合理的地方酸茴，在舊版本中做了修改，發(fā)現(xiàn)新版本還是沒有變化兢交。所以將修改遷移過來薪捍。
- 刪除默認打開淘寶鏈接，這個不是很合適。
文件位置incubator-weex-master/ios/sdk/WeexSDK/Sources/Engine/WXSDKEngine.m
+ (void)registerDefaults
{
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
[self _registerDefaultComponents];
[self _registerDefaultModules];
[self _registerDefaultHandlers];
});
// 在我們的應(yīng)用中默認打開淘寶鏈接酪穿，我們認為是不妥當(dāng)?shù)牡矢桑苯觿h除，什么也不做最干脆
// [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"taobao://"]];
}
-
scrollToComponent方法昆稿，當(dāng)偏移量是負數(shù)時纺座，不移動。
文件位置incubator-weex-master/ios/sdk/WeexSDK/Sources/Component/WXScrollerComponent.m
- (void)scrollToComponent:(WXComponent *)component withOffset:(CGFloat)offset animated:(BOOL)animated
{
UIScrollView *scrollView = (UIScrollView *)self.view;
CGPoint contentOffset = scrollView.contentOffset;
CGFloat scaleFactor = self.weexInstance.pixelScaleFactor;
if (_scrollDirection == WXScrollDirectionHorizontal) {
CGFloat contentOffetX = [component.supercomponent.view convertPoint:component.view.frame.origin toView:self.view].x;
contentOffetX += offset * scaleFactor;
if (contentOffetX > scrollView.contentSize.width - scrollView.frame.size.width) {
contentOffset.x = scrollView.contentSize.width - scrollView.frame.size.width;
} else {
contentOffset.x = contentOffetX;
}
} else {
CGFloat contentOffetY = [component.supercomponent.view convertPoint:component.view.frame.origin toView:self.view].y;
contentOffetY += offset * scaleFactor;
CGFloat scrollContentOffsetY = scrollView.contentSize.height - scrollView.frame.size.height;
if (scrollContentOffsetY <= 0.0f) {
return; //偏移量是負數(shù)的時候溉潭，不要移動净响。SDK中沒有這部分判斷，0.8.0到現(xiàn)在的0.10.0都沒有喳瓣，我們認為這是一個bug馋贤，需要修改
} else if ( contentOffetY > scrollContentOffsetY) {
contentOffset.y = scrollContentOffsetY;
} else {
contentOffset.y = contentOffetY;
}
}
[scrollView setContentOffset:contentOffset animated:animated];
}
- Weex定時器在weex頁面不可見時，不觸發(fā)畏陕。
文件位置incubator-weex-master/ios/sdk/WeexSDK/Sources/Module/WXTimerModule.m
- (void)trigger
{
if (_weexInstance.state == WeexInstanceDisappear ||
_weexInstance.state == WeexInstanceBackground ||
_weexInstance.state == WeexInstanceDestroy) {
return; // Weex頁面不可見配乓，定時器不觸發(fā)
}
[[WXSDKManager bridgeMgr] callBack:_weexInstance.instanceId funcId:_callbackID params:nil keepAlive:_shouldRepeat];
}
其他修改
自定義的模塊
Module和組件component都不需要修改，換了SDK之后絕大部分仍然可以用惠毁。（我們一般都是取自定義文件名犹芹，復(fù)制相關(guān)weex文件的實現(xiàn)，然后做自定義的修改）Weex的模塊Module或者組件component修改了鞠绰，并且我們碰巧也復(fù)制了這個文件進行自定義組件的開發(fā)腰埂，那么相應(yīng)的自定義的模塊Module或者組件component文件將新的SDK中的內(nèi)容遷移過來。
比如WXModalUIModule.m和WXTextInputComponent.m這兩個文件蜈膨，新版本在老版本的基礎(chǔ)上有修改屿笼，而我們也復(fù)制了這兩個文件內(nèi)容，修改一下前綴翁巍，自定義了新的內(nèi)容驴一，比如XXXModalUIModule.m和XXXTextInputComponent.m。這種情況灶壶，我們把新SDK中的修改遷移到我們的自定義文件中肝断，SDK本身的文件不動，測試一下功能正常就好了例朱。
環(huán)境工具更新
- 刪除舊工具孝情，終端命令如下：
npm uninstall -g weex
npm uninstall -g weex-toolkit
- 安裝新工具，終端命令如下：
npm install -g weex-toolkit
npm install -g weex-builder
npm install -g weexpack // (可選)
- 其他修改看具體的系統(tǒng)配置洒嗤。比如我們用
Python寫了幾個自動編譯上傳的小工具，需要做相應(yīng)的調(diào)整魁亦。
.we改為.vue介紹
.we不改渔隶，在新的SDK下也是可以用的。我們這次就沒有動，先讓測試驗證新的SDK功能正常间唉。官網(wǎng)上提供了一個工具绞灼，可以將
.we自動改為.vue
songsiqi/weex-vue-migration
我們暫時不準(zhǔn)備改老的文件，新的文件可以考慮直接上.vue呈野，所以這個工具暫時沒有使用低矮。官網(wǎng)上有兩篇參考文章，照著做被冒，將
.we改為.vue應(yīng)該不是難事军掂。我們的方法是逐步修改，老的.we文件可以長時間存在昨悼，逐步過渡到.vue源文件蝗锥。
如何將原有 Weex 項目改造成 Vue 版本
Weex 和 Vue 2.x 的語法差異
