通过Stage模型开发iOS端应用指南
简介
本文介绍将ArkUI框架扩展到iOS平台所需要的必要类及其使用说明,开发者基于OpenHarmony,可复用大部分的应用代码(生命周期等)并可以部署到iOS平台,降低跨平台应用开发成本。
ArkUI-X和iOS平台集成所用关键类
开发前请熟悉鸿蒙开发指导文档:gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
StageViewController
StageViewController是Stage模型iOS端视图控制器基类,若要实现跨平台基础能力及触发对应ability生命周期,所有iOS端应用级别的视图控制器均要继承于StageViewController。
公共属性
- instanceName:StageViewController唯一标识,拼接规则为bundleName:moduleName:abilityName,其中bundleName的值来自于OpenHarmony应用中app.json5配置文件,moduleName、abilityName的值来自于OpenHarmony应用中的module.json5配置文件。
@property (nonatomic, readonly) NSString *instanceName;
- params:StageViewController外部属性,用于startAbility时传递的want参数。
@property (nonatomic, strong) NSString *params;
初始化方法
- (instancetype)initWithInstanceName:(NSString *_Nonnull)instanceName;
StageApplication
StageApplication本质上是一个调度类,主要用于触发内部相关类实现路径解析与配置、注册应用相关的configuration信息、触发ability部分生命周期事件等。
公共方法
- 配置本地hap包路径。
+ (void)configModuleWithBundleDirectory:(NSString *_Nonnull)bundleDirectory;
- iOS应用触发StartAbility、配置进程id、本地化信息、configuration等。
+ (void)launchApplication;
- 触发ability进入前台生命周期事件。
+ (void)callCurrentAbilityOnForeground;
- 触发ability进入后台生命周期事件。
+ (void)callCurrentAbilityOnBackground;
- 处理单/多实例ability。
+ (BOOL)handleSingleton:(NSString *)bundleName moduleName:(NSString *)moduleName abilityName:(NSString *)abilityName;
- 释放导航视图栈内的所有viewController,触发OnDestory事件。
+ (void)releaseViewControllers;
- 获取导航视图栈最顶层viewController。
+ (StageViewController *)getApplicationTopViewController;
AppDelegate内关键实现参考
ArkUI应用启动及初始化
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 配置hap包路径
[StageApplication configModuleWithBundleDirectory:@"arkui-x"];
// 启动ability
[StageApplication launchApplication];
// APP自启动,初始化StageViewController子类VC,并设置为APP根视图控制器
if (!launchOptions.count) {
NSString *instanceName = [NSString stringWithFormat:@"%@:%@:%@",@"com.example.iosabilitystage", @"entry", @"MainAbility"];
EntryMainViewController *mainView = [[EntryMainViewController alloc] initWithInstanceName:instanceName];
UINavigationController *navi = [[UINavigationController alloc]initWithRootViewController:mainView];
self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
self.window.rootViewController = navi;
[self.window makeKeyAndVisible];
}
return YES;
}
ArkUI应用实现页面跳转
当在iOS平台上使用[startability]接口实现页面跳转时,需要参考下述示例进行开发。
- 通过路由模式(openURL:)实现的iOS应用页面跳转回调,获取传递参数
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
// 根据规则截取URL相应参数
NSString *bundleName = url.scheme;
NSString *moduleName = url.host;
NSString *abilityName, *params;
NSURLComponents *urlComponents = [NSURLComponents componentsWithString:url.absoluteString];
NSArray <NSURLQueryItem *> *array = urlComponents.queryItems;
for (NSURLQueryItem * item in array) {
if ([item.name isEqualToString:@"abilityName"]) {
abilityName = item.value;
} else if ([item.name isEqualToString:@"params"]) {
params = item.value;
}
}
// 单实例ability处理
if ([StageApplication handleSingleton:bundleName moduleName:moduleName abilityName:abilityName] == YES) {
return YES;
}
[self handleOpenUrlWithBundleName:bundleName
moduleName:moduleName
abilityName:abilityName
params:params, nil];
return YES;
}
- 通过解析url得到的参数,映射ability对应的viewController
- (BOOL)handleOpenUrlWithBundleName:(NSString *)bundleName
moduleName:(NSString *)moduleName
abilityName:(NSString *)abilityName
params:(NSString *)params, ...NS_REQUIRES_NIL_TERMINATION {
NSString *instanceName = [NSString stringWithFormat:@"%@:%@:%@",bundleName, moduleName, abilityName];
// 根据moduleName和abilityName映射对应的viewController
// 注意:传入的moduleName或者abilityName错误,则无法找到对应的viewController,此时无法打开页面。
if ([moduleName isEqualToString:@"entry"] && [abilityName isEqualToString:@"MainAbility"]) {
EntryMainAbilityViewController *entryMainVC = [[EntryMainAbilityViewController alloc] initWithInstanceName:instanceName];
entryMainVC.params = params;
} else if ([moduleName isEqualToString:@"entry"] && [abilityName isEqualToString:@"Other"]) {
EntryOtherViewController *entryOtherVC = [[EntryOtherViewController alloc] initWithInstanceName:instanceName];
entryOtherVC.params = params;
}
return YES;
}
ArkUI应用生命周期回调相应处理
- ArkUI应用进入后台,触发对应生命周期事件。
- (void)applicationDidEnterBackground:(UIApplication *)application {
[StageApplication callCurrentAbilityOnBackground];
}
- ArkUI应用进入前台,触发对应生命周期事件。
- (void)applicationWillEnterForeground:(UIApplication *)application {
[StageApplication callCurrentAbilityOnForeground];
}
- 终止ArkUI应用程序进程。
- (void)applicationWillTerminate:(UIApplication *)application {
[StageApplication releaseViewControllers];
}
注 具体方法使用参考samples示例
Ability与ViewController对应规则
iOS端应用info配置里的bundleName需要与Ability的bundleName一致。
iOS端应用内的viewController的viewControllerName组成规则:Ability的moduleName + Ability的abilityName + “viewController”。
StageApplication初始化支持以下两种方式
在didFinishLaunchingWithOptions函数中进行初始化
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 配置hap包路径
[StageApplication configModuleWithBundleDirectory:@"arkui-x"];
// 启动ability
[StageApplication launchApplication];
// APP自启动,初始化StageViewController子类VC,并设置为APP根视图控制器
if (!launchOptions.count) {
NSString *instanceName = [NSString stringWithFormat:@"%@:%@:%@",@"com.example.iosabilitystage", @"entry", @"MainAbility"];
EntryMainViewController *mainView = [[EntryMainViewController alloc] initWithInstanceName:instanceName];
UINavigationController *navi = [[UINavigationController alloc]initWithRootViewController:mainView];
self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
self.window.rootViewController = navi;
[self.window makeKeyAndVisible];
}
return YES;
}
在openURL回调函数中进行初始化
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 不在此处进行初始化
ExampleViewController *mainView = [[ExampleViewController alloc] init];
UINavigationController *navi = [[UINavigationController alloc]initWithRootViewController:mainView];
self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
self.window.rootViewController = navi;
[self.window makeKeyAndVisible];
return YES;
}
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
// 初始化StageApplication
[StageApplication configModuleWithBundleDirectory:@"arkui-x"];
[StageApplication launchApplication];
/*
other code
*/
return YES;
}
鸿蒙开发岗位需要掌握那些核心要领?
目前还有很多小伙伴不知道要学习哪些鸿蒙技术?不知道重点掌握哪些?为了避免学习时频繁踩坑,最终浪费大量时间的。
自己学习时必须要有一份实用的鸿蒙(Harmony NEXT)资料非常有必要。 这里我推荐,根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了:【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。
废话就不多说了,接下来好好看下这份资料。
如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。鸿蒙OpenHarmony知识←前往。下面是鸿蒙开发的学习路线图。
针对鸿蒙成长路线打造的鸿蒙学习文档。鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,帮助大家在技术的道路上更进一步。
其中内容包含:
《鸿蒙开发基础》鸿蒙OpenHarmony知识←前往
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》鸿蒙OpenHarmony知识←前往
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙开发实战》鸿蒙OpenHarmony知识←前往
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
最后
鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行!