最近做了一个纯H5的APP,直接创建UIWebView通过地址打开H5页面,通过注入js代码或者添加onclick事件实现交互。 本来顺风顺水的完成了,后来老大说咱们玩一个好玩的东西——HBuilder,集成5+SDK对我们当前项目有以下好处:
1、引用hbuilder一方面能解决当前相对精确位置获取的问题
2、可以方便以后不依赖ios和android原生开发插件就直接调用原生的功能
废话不多说,直接说下我集成HTML5+SDK的过程
HTML5+SDK一共三种集成方式,“独立应用”、“Widget”和“WebView”
1、独立应用集成方式: 使用独立应用方式,开发者需要将HTML5+SDK生成的首页面设置为当前View的subView。HTML5+ SDK将对应用进行管理。
2、Widget集成方式: 运行方式和独立运行方式类似,开发者在集成时可在需要的位置启动HTML5+ SDK,显示指定的HTML5+应用。
3、Webview集成方式: 用户可在任何页面将HTML5+ SDK的页面以Webview的形式独立显示,显示的Webview页面
下载好的文件包
1、在工程中引入HTML5+ SDK扩展功能的.a文件,开发者可以根据需求添加不同的扩展插件。必须要引入的是liblibPDRCore.a 和libcoreSupport.a,liblibPDRCore.a库是HTML5+SDK运行的基础库文件,libcoreSupport文件是PDRCore依赖的文件。
同时还需要在Bundles文件夹中把PandoraApi.bundle加入到工程中(这是非常重要的,官方文档没说明)
在引入lib文件将SDK/libs目录下的静态库文件拖入到Xcode工程里即可
注意:开发者在使用示例工程时建议不要把工程从SDK目录里挪出来,如果要移动工程可以通过修改library search path ,framework search path 和head search path来解决报错。
在集成5+SDK时必须在Other Linker Flags 里添加 -ObjC, 同时还需要引入如下几个库文件
liblibUI.a、liblibPDRCore.a、libcoreSupport.a、liblibNavigator.a
2、拖入5+SDK的头文件和xml文件
3、开发者可以根据需求添加不同的扩展插件,拖入自己需要的扩展功能的.a文件,并添加相应的依赖库。
4、配置文件的APPID和添加资源文件到工程中
需要将开发完成的HTML5+ 应用拷贝到Pandora/apps/[APPID]/www目录下,然后拖到工程中
以上集成5+SDK基本完成
代码部分
//在工程的AppDelegate类的添加代码,当应用启动时设置5+SDK的运行模式
-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
// 设置当前SDK运行模式
return [PDRCore initEngineWihtOptions:launchOptions withRunMode: PDRCoreRunModeWebviewClient];
}
//在应用退出时添加销毁5+SDK运行环境
- (void)applicationWillTerminate:(UIApplication *)application{
// Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
[PDRCore destoryEngine];
}
当前控制器中
// 启动5+运行环境
1)、widget集成方式
-(void)Start5pEngineAsWidget{
PDRCore *h5Engine = [PDRCore Instance];
CGRect newRect =CGRectMake(0, -StatusBarHeight, SCREENWIDTH, SCREENHEIGHT+StatusBarHeight);
_containerView = [[UIView alloc] initWithFrame:newRect]; _containerView.autoresizingMask =UIViewAutoresizingFlexibleWidth|UIViewAutoresizingFlexibleHeight;
// 设置5+内核的Delegate,5+API在修改状态风格和应用是否全屏时会调用 h5Engine.coreDeleagete = self;
h5Engine.persentViewController =self;
[self.view addSubview:_containerView];
// 设置WebApp所在的目录,该目录下必须有mainfest.json
NSString* pWWWPath = [[[NSBundle mainBundle] bundlePath]stringByAppendingPathComponent:@"Pandora/apps/H57DE8278/www/"];
// 设置5+SDK运行的View
[h5Engine setContainerView:_containerView];
// 传入参数可以在页面中通过plus.runtime.arguments参数获取
NSString* pArgus = @"id=plus.runtime.arguments";
// 启动该应用
pAppHandle = [[[PDRCore Instance] appManager]openAppAtLocation:pWWWPath withIndexPath:@"index.html" withArgs:pArgus withDelegate:nil];
}
2)、webview集成方式
// 启动5+运行环境
-(void)Start5pEngineAsWidget {
PDRCore* pCoreHandle = [PDRCore Instance];
if (pCoreHandle != nil) {
NSString * pFilePath = [NSString stringWithFormat:@"file://%@/%@", [NSBundle mainBundle].bundlePath, @"Pandora/apps/H57DE8278/www/index.html#/home/first"]; [pCoreHandle start];
// 如果路径中包含中文,或Xcode工程的targets名为中文则需要对路径进行编码 // NSString * pFilePath1 = (NSString *)CFBridgingRelease(CFURLCreateStringByAddingPercentEscapes( kCFAllocatorDefault, (CFStringRef)pFilePath, NULL, NULL, kCFStringEncodingUTF8 )); // 用户在集成5+SDK时,需要在5+内核初始化时设置当前的集成方式,
if (@available(iOS 11.0, *)) {
CGRect StRect = CGRectMake(0, StatusBarHeight, SCREENWIDTH, SCREENHEIGHT-StatusBarHeight-BottomHeight);
appFrame = [[PDRCoreAppFrame alloc] initWithName:@"WebViewID1" loadURL:pFilePath frame:StRect];
} else {
CGRect StRect = CGRectMake(0, 0, SCREENWIDTH, SCREENHEIGHT-BottomHeight); appFrame = [[PDRCoreAppFrame alloc] initWithName:@"WebViewID1" loadURL:pFilePath frame:StRect];
}
if (appFrame) {
[pCoreHandle.appManager.activeApp.appWindow registerFrame:appFrame]; [self.view addSubview:appFrame];
}
} }