weex集成iOS

前言

由于项目的需要,最近接触了一下weex开发,本人刚入门不久,由于weex官方文档的坑太多.....这里主要介绍的是集成weex到iOS项目中所需要做的工作,以及运行出一个初级Demo,本文默认读者有一定的iOS基础

环境前端搭建

首先,你需要 Node.js (Node.js 为前端开发环境)
安装 Node.js 方式多种多样,最简单的方式是在 Node.js 官网 下载可执行程序直接安装即可。
对于 Mac,可以使用 Homebrew 进行安装:

$ brew install node

安装完成后,可以使用以下命令检测是否安装成功:


57FFB8F2-26C5-4343-8C31-22B27EC385BD.png

通常,安装了 Node.js 环境,npm 包管理工具也随之安装了。因此,直接使用 npm 来安装 weex-toolkit。

$ npm install -g weex-toolkit

升级weed-toolkit子依赖

$ weex update weex-devtool@latest

升级完之后查看版本以及子依赖

$ weex -v
1A0E08ED-2F55-4E41-81F3-59479B50412F.png

到这里前端的环境就搭建完毕了。

搭建前端项目

创建一个文件夹,用于存放weex项目,通过终端cd 到该路径下
在该路径下执行weex命令创建项目

$ weex create weexDemo

执行完命令后,在目录中就创建了一个使用 Weex 和 Vue 的模板项目。


E369F145-FC10-4245-97CB-843E56DD4547.png

这里,你可以cd到weexDemo 目录下,执行前端依赖操作

$ npm install

该操作会将package.json目录下的依赖安装到weex项目中
之后运行根目录下的 npm run dev & npm run serve 开启 watch 模式和静态服务器。

 npm run dev & npm run serve

跳出这个界面,weex前端项目搭建完成


43F17885-DEC2-4DCC-A5A5-FE4D72C9C07E.png

嵌入iOS项目

使用cocoaPod 导入weex项目以及相关第三方框架
在Podfile 文件中加入以下依赖

source 'git@github.com:CocoaPods/Specs.git'
target 'weexDemo' do
    platform :ios, '7.0'
    pod 'WeexSDK'
    pod 'SDWebImage', '3.7.5'
    pod 'WXDevtool', '0.15.3'
    pod 'ATSDK-Weex', '0.0.1'
end

执行pod install 安装依赖

$ pod install

安装成功后我们需要在iOS项目中搭建weex环境
appDelegate 中导入 weexSDK

#import <WeexSDK/WXSDKEngine.h>
#import <WeexSDK/WXDebugTool.h>
#import <WeexSDK/WXLog.h>
#import <WeexSDK/WXAppConfiguration.h>

didFinishLaunchingWithOptions 方法中添加 weex 环境

    //业务配置,非必需
    [WXAppConfiguration setAppGroup:@"AliApp"];
    [WXAppConfiguration setAppName:@"WeexDemo"];
    [WXAppConfiguration setAppVersion:@"1.0.0"];
    
    //初始化SDK环境
    [WXSDKEngine initSDKEnvironment];

在要显示的界面上添加代码

//
//  ViewController.m
//  weexDemo
//
//  Created by yumq on 2017/11/22.
//  Copyright © 2017年 yumq. All rights reserved.
//

#import "ViewController.h"
#import <WeexSDK/WXSDKInstance.h>
@interface ViewController ()

@property (nonatomic, strong) WXSDKInstance *instance;
@property (nonatomic, strong) UIView *weexView;
@property (nonatomic, assign) CGFloat weexHeight;
@end

@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    _weexHeight = self.view.frame.size.height - 64;
    [self.navigationController.navigationBar setHidden:YES];
    [self render];
}

- (void)dealloc
{
    [_instance destroyInstance];
}

- (void)render
{
    _instance = [[WXSDKInstance alloc] init];
    _instance.viewController = self;
    CGFloat width = self.view.frame.size.width;
    _instance.frame = CGRectMake(self.view.frame.size.width-width, 0, width, _weexHeight);
    
    __weak typeof(self) weakSelf = self;
    _instance.onCreate = ^(UIView *view) {
        [weakSelf.weexView removeFromSuperview];
        weakSelf.weexView = view;
        [weakSelf.view addSubview:weakSelf.weexView];
        UIAccessibilityPostNotification(UIAccessibilityScreenChangedNotification, weakSelf.weexView);
    };
    _instance.onFailed = ^(NSError *error) {
        NSLog(@"failed %@",error);
    };
    
    _instance.renderFinish = ^(UIView *view) {
        NSLog(@"render finish");
    };
    
    _instance.updateFinish = ^(UIView *view) {
        NSLog(@"update Finish");
    };
    NSString *url = [NSString stringWithFormat:@"file://%@/index.js",[NSBundle mainBundle].bundlePath];
    
    [_instance renderWithURL:[NSURL URLWithString:url] options:@{@"bundleUrl":url} data:nil];
}
- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}
@end

到这里,我们iOS的简单界面基本搭建完毕,接下来,我们需要使用之前创建的前端框架打包生成js 文件,放入项目中,让iOS 加载并生成界面
我们cd 到之前创建的项目的src目录下执行打包操作

weex compile ./ ../assets/
F1E077D0-3EEA-49BF-91B0-3800D6FE9F5E.png

打包完后,在assets 下会多出index.js 文件,将文件拷入iOS 项目中,

由于是加载bundle的文件,所以导入的时候不能仅仅是引用,请注意

接下来运行项目


124CEE6F-FED9-434E-B205-131D76498AC6.png

创建成功

Tip :这里你可能会遇到图片加载不出来的问题

据我所知,weex需要一个适配器去让框架了解图片的加载方式才能加载出图片
这里,引用官方适配器
创建一个WXImgLoaderDefaultImpl 类,在WXImgLoaderDefaultImpl中添加以下代码

WXImgLoaderDefaultImpl.h

#import <Foundation/Foundation.h>
#import <WeexSDK/WeexSDK.h>
#import <SDWebImageManager.h>


@interface WXImgLoaderDefaultImpl : NSObject<WXImgLoaderProtocol, WXModuleProtocol>
@end

WXImgLoaderDefaultImpl.m

#import "WXImgLoaderDefaultImpl.h"
#import <SDWebImage/UIImageView+WebCache.h>

#define MIN_IMAGE_WIDTH 36
#define MIN_IMAGE_HEIGHT 36

#if OS_OBJECT_USE_OBJC
#undef  WXDispatchQueueRelease
#undef  WXDispatchQueueSetterSementics
#define WXDispatchQueueRelease(q)
#define WXDispatchQueueSetterSementics strong
#else
#undef  WXDispatchQueueRelease
#undef  WXDispatchQueueSetterSementics
#define WXDispatchQueueRelease(q) (dispatch_release(q))
#define WXDispatchQueueSetterSementics assign
#endif

@interface WXImgLoaderDefaultImpl()

@property (WXDispatchQueueSetterSementics, nonatomic) dispatch_queue_t ioQueue;

@end

@implementation WXImgLoaderDefaultImpl

#pragma mark -
#pragma mark WXImgLoaderProtocol

- (id<WXImageOperationProtocol>)downloadImageWithURL:(NSString *)url imageFrame:(CGRect)imageFrame userInfo:(NSDictionary *)userInfo completed:(void(^)(UIImage *image,  NSError *error, BOOL finished))completedBlock
{
    if ([url hasPrefix:@"//"]) {
        url = [@"http:" stringByAppendingString:url];
    }
    return (id<WXImageOperationProtocol>)[[SDWebImageManager sharedManager]downloadImageWithURL:[NSURL URLWithString:url] options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
        
    } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
        if (completedBlock) {
            completedBlock(image, error, finished);
        }
    }];
    
    
}

@end

并在appDelegate中添加环境

[WXSDKEngine registerHandler:[WXImgLoaderDefaultImpl new] withProtocol:@protocol(WXImgLoaderProtocol)];

运行

打包

weex 也有命令可以直接打包出iOS/android项目
执行weex platform add ios 添加iOS平台

weex platform add ios

F3E20AF8-FFA8-48DA-B2A4-BE7D3A46634A.png

执行weex build ios 构建项目

weex build ios
3371DB51-9796-4410-9E7B-7AD88081391B.png

这里输入信息测试的话可以随便填写,即使随便填写了,在项目中也是可以修改的。

感谢您看到这里,如果有所收获,请点击下方的喜欢,对作者的支持,欢迎提供宝贵意见 :)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,590评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,808评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,151评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,779评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,773评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,656评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,022评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,678评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,038评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,756评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,411评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,005评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,973评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,053评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,495评论 2 343

推荐阅读更多精彩内容