JCenter 迁移指南

本文章已授权郭霖微信公众号转载

  • JCenter 远程仓库已经宣布停止维护了,经过一段时间的实践和踩坑,现在由我来给大家讲讲 JCenter 停更带来的影响及分享解决的方案。
  • 进入 Bintray 官网,就会发现有一个很明显的红色横幅,大致的意思是:注意所有 Bintray 服务将被弃用,您的帐户将在 2021 年 5 月 1 日被禁用,学习更多的知识。

  • 点击学习更多,我们可以发现了 Bintray 官方对本次操作做出的解释,由于全是英文,为了方便大家,我直接翻译成中文给大家看:

  • 官方主要讲了三点内容,分别是:

    1. 解释为什么停止维护

    2. 停止维护的时间节点

    3. 常见一些问题的解答

  • 为了节省大家时间,我对内容做了提炼精简,为大家简单解说一下:

    1. Bintray 和 JCenter 因为挣不到钱,所以业务被砍掉了,需要开发者提前做一下迁移。

    2. 截止 2021 年 3 月 30 日之后不能上传任何库,2022 年 2 月 1 日之后不能下载任何库。

    3. 停止维护之后,Bintray 账户将被限制登录,Bintray 官网将不能被访问,所有数据在最后一天从服务器中被删除。

影响范围

  • 先来谈谈这次事件带来的影响:影响范围很广,主要表现为 2022 年 2 月 1 日之后 Android Studio 将无法从 JCenter 仓库拉取任何代码库,统统都会拉取失败,间接导致项目无法编译通过。
  • 这是创建新项目的远程仓库配置,默认只配置了 Google 和 JCenter,这时大家心里可能在想:JCenter 仓库挂掉了没事,反正还有 Google 仓库呢。

  • 但事实却是:Google 仓库是谷歌官方的远程仓库,只存放谷歌官方的一些框架,例如 AndroidX 相关的包都是放在这里的,暂时不对外开放,也就是说现在大家用的第三方框架基本都是放在 JCenter 仓库上,就问你一句方不方?慌不慌?

解决方案

  • 面对问题,我觉得只会慌是解决不了问题的,还是得多想想办法,而不是坐以待毙,我最近花了很多时间研究了这个问题,最后发现解决这个问题其实并不难,JCenter 仓库用不了,可以换成 JCenter 的镜像仓库。

  • 在这里我推荐使用 阿里云云效仓库华为开源镜像站 来解决这一问题,在项目根目录下的 build.gradle 文件中这样配置:

buildscript {
    repositories {
        // 阿里云云效仓库:https://maven.aliyun.com/mvn/guide
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        // 华为开源镜像:https://mirrors.huaweicloud.com
        maven { url 'https://repo.huaweicloud.com/repository/maven' }
        // JitPack 远程仓库:https://jitpack.io
        maven { url 'https://jitpack.io' }
        // MavenCentral 远程仓库:https://mvnrepository.com
        mavenCentral()
        google()
        jcenter()
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://repo.huaweicloud.com/repository/maven' }
        maven { url 'https://jitpack.io' }
        mavenCentral()
        google()
        jcenter()
    }
}
  • 这时大家心中可能有另外一个疑问,为什么 JCenter 仓库挂了,而它的镜像仓库却还能用呢?这个问题要从这个东西诞生的原因说起,由于 JCenter 是外国人开发的,用的是自然是国外的服务器,所以访问起来很慢,从这些地方拉代码自然也快不了,严重影响开发效率,所以国内就诞生了关于 JCenter 的镜像仓库,用于解决这一问题,具体的实现原理是将 JCenter 仓库上的代码库拷贝一份放到国内的服务器的硬盘上面,这样我们再拉取代码库就会快很多,而对于 JCenter 停止维护的事件,其实就是停止外界对服务器的访问,而如果我们重新指向服务器地址,这样是不是就完美避开了访问 JCenter 服务器?从我的认知看来是没有问题的,大家对此也可以提出不同的意见。

迁移方案

  • 上面主要是针对使用者的解决方案,假设我是开源库作者,那么该如何应对这个问题呢?

  • 如果是开源库的作者,只能通过换远程仓库服务商来解决问题,不换的话现在代码库已经上传不了 JCenter,从而导致框架无法发布新的远程依赖。

  • 现在除了 JCenter 方案,其实还有两个备选方案,mavenCentral 和 JitPack,这两个远程仓库也是比较常用,经过对比,我最终选择了 JitPack 作为新的代码库存放仓库,主要的原因也很简单,相比 mavenCentral,JitPack 的流程更简单,主要表现为不需要注册账号,不需要在项目 Gradle 中配置信息,只需要将代码库发布到 Github 即可,最后在 JitPack 构建一下就可以了。

  • 现在由我来给大家演示一下具体的操作方式

  • 第一步:提交代码到 Github 上面(常规操作)

  • 第二步:找到 Github 页面中的 Release 选项

  • 第三步:创建一个新的 release 版本
  • 第四步:填写好相关的信息
  • 第五步:填写完之后点击 Publish release 按钮
  • 第七步:输入 Github 地址,并点击 Look up 按钮
  • 第八步:选择刚刚创建的 10.5 的版本,点击右边的 Get it 按钮
  • 第九步:等待构建完成,等转圈的图标变成文件的图标就说明已经完成
  • 第十步:点击 Get it 按钮,这时会显示代码库远程依赖信息
  • 至此上传代码库到 JitPack 仓库的流程已经讲完,有一点需要的注意是,我们需要在 Github 项目主页中提醒开发者加入:
  • 否则会出现有些开发者拉取不到代码库的问题,这是因为 Studio 创建的工程默认只配置了 Google 仓库和 JCenter 仓库,默认并没有配置 JitPack 仓库。

  • 另外告诉大家一个好消息,我个人的所有框架已如数迁移到 JitPack 仓库了,有使用到我写的框架的同学可以考虑找一个时间点,然后做一下统一升级和迁移,点击此处可以直达 Github 地址

友盟迁移

  • 随着 Bintray 的逐渐关闭,有友盟远程依赖的项目也运行不起来了,编译时提示报错:
Unable to resolve dependency for ':umeng@previewUnitTest/compileClasspath': Could not download common-2.2.5.jar (com.umeng.umsdk:common:2.2.5)
Unable to resolve dependency for ':umeng@preview/compileClasspath': Could not download analytics-8.1.6.jar (com.umeng.umsdk:analytics:8.1.6)
  • 然后我去官网看了一下,果然不出所料,这个不止是我一个人的问题,而是大家都会。
  • 结果发现还是不行,不过我发现最下面有一段话:获取时必须为最新版的SDK,顿时我明白了什么,原来友盟只放了最新版本在 Maven 库上面,why?那我们这些用旧版本的用户怎么办?公告上面也没有写,友盟这工作做得不到位啊,请允许我打个差评。

  • 不过在我看来解决这个问题的方法有两种,大家可以根据自己的实际情况而定。

  • 方法一:升级新版本,可以根据友盟发布的公告进行修改,只不过这种只能升级到最新版本,当然你要是对友盟的 Maven 库没有信心,可以考虑直接下载最新的 Jar 包进行离线依赖。

  • 方法二:沿用旧版本,这块的话友盟没有给出解决方案,但是贸然升级版本必定存在一定的风险,假设测试同学没有空做测试,那么很容易就会出现问题,这个时候为了项目能正常运行,又能以最低的成本来做这件事,依赖原有的旧版本就很有必要了,那么旧版本的 Jar 包该从哪里找呢?我相信很多人第一反应是去 Bintray 官网的友盟仓库中找找看。

  • 正当我高兴的时候,现实狠狠给我泼了一波冷水,我点击下载 common-2.2.5.jar,却发现结果是这个样子的
  • 顿时感觉被命运扼住了喉咙,难道就没有其他办法了吗?

  • 答案其实有的,我小脑瓜忽然灵机一动:去 Github 找找看?

  • 事实证明,只要思想不滑坡,办法总比困难多,你学废了吗?

  • 至于两种方案要选择哪种,我觉得吧,在开发和测试同时都能空出人力来做时,可以优先考虑升级友盟 SDK 来解决问题,这样做还有另外一个好处,新版本的 SDK 肯定是修复了旧版本的某些 Bug,不如趁此机会提升一下应用的稳定性,但是如果没有时间做,也可以先考虑直接找旧版本的 Jar 包来解决问题,毕竟项目要能运行才是目前最最最重要的事情。

  • 到此 JCenter 迁移指南已经全部讲完,感谢大家的观看,大家有什么问题欢迎在评论区指出。

Android 技术讨论 Q 群:10047167

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

推荐阅读更多精彩内容