ionic4 使用热更新插件问题

以前写过另外一篇文章:Ionic 热更新实践笔记,讲了 cordova-hot-code-push-plugin 的使用详细方法。

依赖cordova-hot-code-push-plugin 热更新,在升级到ionic4之后都会遇到白屏的问题,经过调试代码,发现是由于cordova-plugin-ionic-webview升级导致的

cordova-plugin-ionic-webview升级到2.x以上会有如下影响

  • iOS 最低兼容之10+
  • android最低兼容 4.4+
  • GCDWebServer 不支持带转义的字符,比如 cordova-hot-code-push-plugin 的存储位置是 Application Support, 在URL转义后变成 Application%20Support , 此时GCDWebServer无法找到该路径,所以会白屏
  • 1.0时GCDWebServer的默认localserver 根目录是APP的根目录,而2.x之后改成了包中www目录,热更新后新的目录在 Application Support对应的www中,与localserver的根目录不符,所以此时也无法找到

针对以上基础改动,我们可以采取如下措施

1. iOS 打包target 改为10+

根据苹果官网的统计:https://developer.apple.com/support/app-store/

iOS 10 以上的版本占据了95%的市场份额,相对来说兼容10以下的性价比太低

2. android 兼容 至4.4+

根据安卓官方统计:https://developer.android.com/about/dashboards?hl=zh-cn

4.4以下的版本份额不足4%,所以低版本的也可以不给予考虑

3. 改动 cordova-hot-code-push-plugin的存储位置

cordova-hot-code-push-plugin 存储位置改为非 Application Support 的目录,比如cacheDirectory。此处只需要改动iOS对应的代码,如下:

HCPFilesStructure.mpluginRootFolder方法中做如下改动

  NSURL *supportDir = [fileManager applicationSupportDirectory];

改为

  NSURL *supportDir = [fileManager applicationCacheDirectory];

4. 在热更新插件启动完毕和热更新文件下载完毕后重设localserver根目录,并重启localserver

安卓改动:

只需要改动 redirectToLocalStorageIndexPage方法,使用到了java的反射机制

    private void redirectToLocalStorageIndexPage() {
        final String indexPage = getStartingPage();

        // remove query and fragment parameters from the index page path
        // TODO: cleanup this fragment
        String strippedIndexPage = indexPage;
        if (strippedIndexPage.contains("#") || strippedIndexPage.contains("?")) {
            int idx = strippedIndexPage.lastIndexOf("?");
            if (idx >= 0) {
                strippedIndexPage = strippedIndexPage.substring(0, idx);
            } else {
                idx = strippedIndexPage.lastIndexOf("#");
                strippedIndexPage = strippedIndexPage.substring(0, idx);
            }
        }

        // make sure, that index page exists
        String external = Paths.get(fileStructure.getWwwFolder(), strippedIndexPage);
        if (!new File(external).exists()) {
            Log.d("CHCP", "External starting page not found. Aborting page change.");
            return;
        }
        try {
            Log.d("CHCP", "begin restart app");
            String basePath = fileStructure.getWwwFolder();
            // 尝试重置本地服务器根目录为当前热更新后的外置存储路径
            Class[] cArg = new Class[1];
            cArg[0] = String.class;
            // 此处重置loacalserver的根目录
            webView.getEngine().getClass().getDeclaredMethod("setServerBasePath", cArg).invoke(webView.getEngine(),
                    basePath);
        } catch (NoSuchMethodException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IllegalAccessException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (InvocationTargetException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (SecurityException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();

        }

        Log.d("CHCP", "Loading external page: " + external);
    }

iOS改动:

iOS的改动有两处,一处是热更新拆件加载完毕后和热更新文件下载完成后都需要重定向localserver的根目录

为了与其他插件耦合,采用了objective-c的

添加如下方法:

/**
 * 切换本地服务根目录到外存储目录
 */
-(void) switchServerBaseToExternalPath{
    
    NSString * basePath = [_filesStructure.wwwFolder.absoluteString stringByReplacingOccurrencesOfString:@"file://" withString:@""];
    // 先要确保webVieEngine能响应以下两个方法
    if([self.webViewEngine respondsToSelector:@selector(setServerPath:)] && [self.webViewEngine respondsToSelector:@selector(basePath)]){
        // 先判断之前的本地服务根目录是否与将要切换的路径相同,如果不相同则切换,否则不切换
        NSString * preBasePath = [self.webViewEngine performSelector:@selector(basePath)];
        if( ![preBasePath isEqualToString:basePath] && [[NSFileManager defaultManager] fileExistsAtPath:basePath]){
            
            dispatch_async(dispatch_get_main_queue(), ^{
                // 此处需要在主线程中调用,否则会出现意想不到的错误
                [self.webViewEngine performSelector:@selector(setServerPath:) withObject:basePath];
            });
            
        }
        NSLog(@"reset the base server success, start reload app");
    }else{
        // 如果不能响应,则不需要再调用切换了,保持APP在未更新状态
        NSLog(@"cannot reset the base server, keep current page");
    }
}

并在改动resetIndexPageToExternalStorage的代码如下:

/**
 *  Redirect user to the index page that is located on the external storage.
 */
- (void)resetIndexPageToExternalStorage {
    NSString *indexPageStripped = [self indexPageFromConfigXml];
    
    NSRange r = [indexPageStripped rangeOfCharacterFromSet:[NSCharacterSet characterSetWithCharactersInString:@"?#"] options:0];
    if (r.location != NSNotFound) {
        indexPageStripped = [indexPageStripped substringWithRange:NSMakeRange(0, r.location)];
    }
    
    NSURL *indexPageExternalURL = [self appendWwwFolderPathToPath:indexPageStripped];
    if (![[NSFileManager defaultManager] fileExistsAtPath:indexPageExternalURL.path]) {
        return;
    }
    
    // rewrite starting page www folder path: should load from external storage
    if ([self.viewController isKindOfClass:[CDVViewController class]]) {
        // 在此处重置localserver
        [self switchServerBaseToExternalPath];
    } else {
        NSLog(@"HotCodePushError: Can't make starting page to be from external storage. Main controller should be of type CDVViewController.");
    }
}

fork了一份 **cordova-hot-code-push-plugin **的代码,并做了相应的改动,如果想用可以直接fork一下然后自己打npm的包,地址:https://github.com/amosbaby/cordova-hot-code-push

当然, 我也带了一个npm的包,名字叫做 teh-hot-code-push-plugin

安装方法:

cordova plugin add teh-hot-code-push-plugin 

其他与原来 插件没啥区别。亲测可用,如有问题,随时可以提issues或者评论。

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

推荐阅读更多精彩内容