Gradle的环境配置

原文地址：https://www.cnblogs.com/baiqiantao/p/6890674.html

Installing Gradle: https://docs.gradle.org/current/userguide/installation.html

• gradlew 和 gradlew.bat：封装 gradle 的脚本，目的是为了更方便的使用 gradle
• 环境变量 GRADLE_HOME：仅仅是为了可以在任意目录中执行 gradle 命令，没有特殊的意义
• 环境变量 GRADLE_USER_HOME：控制在命令行中执行 gradlew 命令时，gradle 下载的目录
• IDEA 的 Gradle user home：控制在 IDEA 点击按钮执行各项 Task 等功能时，gradle 下载的目录
• IDEA 的 User from gradle：控制在 IDEA 点击按钮执行各项 Task 等功能时，使用的 gradle 的版本

环境变量 GRADLE_HOME

设置环境变量 GRADLE_HOME 的目的，仅仅是为了方便在 Path 中指定 gradle 的位置。
GRADLE_HOME：D:_dev\gradle_GRADLE_HOME\gradle-6.7
Path：%GRADLE_HOME%\bin
将 gradle 添加到 Path 的目的是为了，可以在任意目录中执行 gradle 命令。
实际上，完全没必要设置环境变量 GRADLE_HOME，Do we really need GRADLE_HOME?

1
2
3
4
5
6

gradle -v           # 查看版本
gradle --help       # 查看命令使用帮助

λ where gradle      # 查看 gradle 命令位置
D:\_dev\gradle\GRADLE_HOME\gradle-6.7\bin\gradle
D:\_dev\gradle\GRADLE_HOME\gradle-6.7\bin\gradle.bat

gradlew 是干嘛的

其实 gradlew 只是一个 gradle 的封装(wrapper)，gradlew = gradle wrapper，因为在项目根目录有 gradlew 和 gradlew.bat 这两个可执行文件，所以 能且仅能 在项目根目录中执行 gradlew 命令。

1
2
3
4
5
6

D:\_dev\_code\as\Test> gradlew -v       # 查看版本
D:\_dev\_code\as\Test> gradlew --help   # 查看命令使用帮助

D:\_dev\_code\as\Test> where gradlew    # 查看 gradlew 命令位置
D:\_dev\_code\as\Test\gradlew
D:\_dev\_code\as\Test\gradlew.bat

这两个文件头部的注释也说明了他们的作用：

• gradlew：Gradle start up script for UN*X
• gradlew.bat：Gradle startup script for Windows

之所以添加这个 gradlew 脚本，是为了：

统一项目所使用的 gradle 版本，避免不同开发人员使用不同的 gradle 版本导致的兼容性问题
可以把 gradle-wrapper.properties 里面的下载 gradle 的地址切换到公司的公共空间上，以加快下载速度

1

distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-all.zip

环境变量 GRADLE_USER_HOME

设置环境变量 GRADLE_USER_HOME 的目的，是为了自定义下载 gradle 时的本地存储路径。
在命令行中执行 gradlew 命令(注意不是 gradle 命令)时，会将对应版本的 gradle 下载到此目录中。
下载 gradle 时，下载地址及版本由项目中的 /gradle/wrapper/gradle-wrapper.properties 决定。

1
2
3
4
5
6

#Mon Nov 16 00:55:48 CST 2020
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-all.zip

IDEA 的 Gradle user home

在 IDEA 的 File | Settings | Build, Execution, Deployment | Build Tools | Gradle 中，有一个 Gradle user home 的配置，其作用和环境变量 GRADLE_USER_HOME 类似，只不过该配置只是给 IDEA 使用的。譬如点击 gradle 窗口的各种 Task 按钮执行各项 Task 功能时。

注意：仅 IDEA 中的各种图形化操作会使用此配置，在 IDEA 的 Terminal 中执行 gradlew 命令时，使用的依旧是环境变量 GRADLE_USER_HOME。

IDEA 的 User from gradle

在 IDEA 的 File | Settings | Build, Execution, Deployment | Build Tools | Gradle 中，有一个 User from gradle 的配置，它也是仅提供给 IDEA 使用的(对 gradlew 无效)。

其作用是，指定当前工程中 IDEA 所使用的 gradle 版本：

当勾选 gradle-wrapper.properties 时，使用 gradle-wrapper.properties 中指定的 gradle 版本。
为了防止和在 Terminal 中执行 gradlew 命令时使用的 gradle 版本不同，建议勾选此配置(也是默认配置)。
当勾选 Specified location 时，使用指定目录下的 gradle 版本。
如果 gradle 下载很慢，就可以勾选此配置，以便使用指定本地下载好的 gradle 版本。

不管在 IDEA 中怎么配置，在 Terminal 中执行 gradlew 命令时，所使用的 gradle 版本都是由 gradle-wrapper.properties 决定的，并且下载路径也都是由环境变量 GRADLE_USER_HOME 决定的。

org.gradle.java.home 配置

这里的 JDK 指的是执行 Gradle 命令依赖的 JDK，并非 AndroidStudio 工程依赖的 JDK。

通过 File | Settings | Build, Execution, Deployment | Build Tools | Gradle 设置的 JDK，是在运行 IDEA 图形化按钮时使用的。
通过 gradle.properties 设置的 JDK，是在 Terminal 中执行 gradlew 命令时使用的。

1
2
3
4
5
6

# MacOS的路径写法
org.gradle.java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home

# Windows系统的路径写法参考如下
# org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_144
# org.gradle.java.home=C\:/_dev/Android/Android Studio/jre

注意：AGP 从 7.0.0-alpha02 版本起，需要使用 Java 11

启动android默认浏览器

1
2
3
4
5

val intent = Intent()
intent.data = Uri.parse(url)
intent.action = Intent.ACTION_VIEW
intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
context.startActivity(intent)

启动指定浏览器打开（不推荐）

警告：爱加密加固之后的包，会把这个异常给吃掉，导致无法跳转，也无反应。

这种方式需要处理手机中不存在指定浏览器的情况

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

try {
    val intent = Intent()
    intent.data = Uri.parse(targetUrl)
    intent.action = Intent.ACTION_VIEW
    intent.setClassName(
        "com.android.browser",
        "com.android.browser.BrowserActivity"
    ) 
    intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
    context.startActivity(intent)
} catch (e: Exception) {
    e.printStackTrace()

    // android.content.ActivityNotFoundException: Unable to find explicit activity class {com.android.browser/com.android.browser.BrowserActivity}; have you declared this activity in your AndroidManifest.xml?
    val intent = Intent()
    intent.data = Uri.parse(url)
    intent.action = Intent.ACTION_VIEW
    intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
    context.startActivity(intent)
}

由于华为鸿蒙系统已经没有Android默认的浏览器，所以此处必须要有异常处理，或者提前处理手机中不存在指定浏览器的情况。

市场上常用浏览器的包名和类名@20220630

1
2
3
4
5
6

华为: "com.huawei.browser/com.huawei.browser.BrowserMainActivity"
Vivo: "com.vivo.browser/com.vivo.browser.MainActivity"
小米: "name=com.android.browser/com.android.browser.BrowserActivity"
uc浏览器: "com.uc.browser", "com.uc.browser.ActivityUpdate"
opera: "com.opera.mini.android", "com.opera.mini.android.Browser"
qq浏览器: "com.tencent.mtt", "com.tencent.mtt.MainActivity"

RecyclerView 根据滑动位置动态改变背景透明度

根据滑动位置动态改变背景透明度,直接上代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

binding.recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
    override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
        super.onScrolled(recyclerView, dx, dy)
        onRecyclerScrolled(recyclerView, dx, dy)
    }

    override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
        super.onScrollStateChanged(recyclerView, newState)
    }
})

private val dp180 = dp2px(180)
private var distanceY = 0
private var current = 0
private fun onRecyclerScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
    distanceY += dy
    when {
        distanceY >= dp180 -> {
            if (current == 1) return
            recyclerView.setBackgroundColor(Color.argb(255, 246, 248, 250))
            current = 1
        }
        distanceY <= 0 -> {
            if (current == 0) return
            recyclerView.setBackgroundColor(Color.argb(0, 246, 248, 250))
            current = 0
        }
        else -> {
            recyclerView.setBackgroundColor(
                Color.argb(
                    distanceY * 255 / dp180,
                    246, 248, 250
                )
            )
            current = -1
        }
    }
}

Android 分享功能

友盟分享SDK

https://developer.umeng.com/docs

友盟分享，QQ和QQ空间分享成功了，却总是回调分享取消

qqzone_id_value 配置跟当前应用对应不上,PlatformConfig.setQQZone(qqzone_id_value, qqzone_secret_id_value)

Windows 上配置 Git SSH

https://support.atlassian.com/bitbucket-cloud/docs/set-up-an-ssh-key/

0x01 Set up SSH for Git on Windows

Use this section to create a default identity and SSH key when you’re using Git on Windows. By default, the system adds keys for all identities to the /Users/<username>/.ssh directory.

Step 1. Set up your default identity

From the command line, enter ssh-keygen.

ssh-keygen -t rsa -b 4096 -C "email"

List the contents of .ssh to view the key files.

1
2

$ dir .ssh 
id_rsa  id_rsa.pub

Step 2. Add the key to the ssh-agent

If you don’t want to type your password each time you use the key, you’ll need to add it to the ssh-agent.

1
2

$ eval $(ssh-agent) 
$ ssh-add ~/.ssh/id_rsa 

Step 3. Add the public key to your Account settings

Open your .ssh/id_rsa.pub file and copy its contents.

From Bitbucket, Paste the copied public key into the SSH Key field. Click Save.

Step 4. Test connection

Return to the command line and verify your configuration and username by entering the following command:

1

$ ssh -T git@bitbucket.org   

0x02 Working with non-default SSH key pair paths

If you used a non-default file path for your GitLab SSH key pair,
you must configure your SSH client to find your GitLab SSH private key
for connections to your GitLab server (perhaps gitlab.com).

For OpenSSH clients this is configured in the ~/.ssh/config file.
Below are two example host configurations using their own key:

1
2
3
4
5
6
7
8
9

# GitLab.com server
Host gitlab.com
RSAAuthentication yes
IdentityFile ~/.ssh/config/private-key-filename-01

# Private GitLab server
Host gitlab.company.com
RSAAuthentication yes
IdentityFile ~/.ssh/config/private-key-filename

0x03 使用ed25519方式生成SSH秘钥

如果使用rsa加密方式，出现秘钥无效，依旧提示输入用户名密码验证，请通过ed25519加密方式，生成ssh秘钥。

ssh-keygen -t ed25519 -C "email" -b 4096

对应生成的私钥 id_ed25519 和公钥 id_ed25519.pub, 其他配置步骤同rsa生成方式一致。

JsBridge 开源库

项目地址：https://github.com/lzyzsd/JsBridge
使用参考：https://www.jianshu.com/p/7aea03838f19

0x00 从H5界面，跳转Native登录，登录之后重新加载H5页面出现JsBridge注入失败[code=-2,message=net::ERR_NAME_NOT_RESOLVED]

解决方案：
App层销毁当前的WebView，重新加载一个新的WebView去loadUrl。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

// js-bridge register error
// 回调 onReceivedError(WebView view, WebResourceRequest request, WebResourceError error)
// [code=-2,message=net::ERR_NAME_NOT_RESOLVED]
// so you have to destroy webView and rebuild one.
private void reloadWebView() {
    if (mWebView != null) {
        mWebView.destroy();
        mWebView = null;
    }

    initView();
    initWebView();
    webView.loadUrl(url);
}