下载 Looker JAR 文件

如需为客户托管的部署安装或更新 Looker 应用，您必须下载 Looker JAR 文件。本页介绍了下载 Looker JAR 文件的两种方法：

  1. 使用下载 Looker JAR 文件网页
  2. 调用 API

您必须先接受最终用户许可协议 (EULA)，然后才能下载 JAR 文件。您可以在下载 Looker JAR 文件网页上查看该协议，并按照本页上的规范进行操作。下载 JAR 文件的每位用户只需接受一次此 EULA。（如果 EULA 将来更新，每位用户还必须接受更新后的版本。）

使用下载 Looker JAR 文件网页

您可以通过以下链接访问下载 Looker JAR 文件网页：https://download.looker.com/validate。如需下载 Looker JAR 文件，请按以下步骤操作：

  1. 输入您的 Looker 许可编号。
  2. 输入您的电子邮件地址。这必须是私自托管的电子邮件网域。

  3. 选择要下载的 Looker 版本。

    如果您选择最新版本，系统会下载当前 Looker 版本的最新 Looker JAR 文件。如果您选择 Specific Version，则需要准确输入 Looker 核心 JAR 文件名。

  4. 点击获取下载链接。

    如果您尚未接受最终用户许可协议，系统会显示最终用户许可协议接受表单。选择阅读条款及条件，即可查看完整的最终用户许可协议。接下来，输入您的名字和姓氏，然后选中我同意本条款及条件旁边的复选框。最后，点击获取下载链接。

  5. 点击下载 1/2 下载 Looker 核心 JAR 文件。然后，点击 Download 2 of 2（下载 2 个文件中的第 2 个）下载 Looker 依赖项 JAR 文件。此链接会在 10 分钟后过期。如果链接失效，您可以重新开始下载流程。

调用 API

在通过调用 API 下载 JAR 文件之前，您必须先通过下载 Looker JAR 文件 网页接受 EULA。

然后，您可以使用任何所需的方法（JavaScript、Java、Ruby、shell 命令等）向 HTTPS 端点发出 POST 请求，从而进行必要的 API 调用。为了使这些请求正常运行，您必须使用 POST 方法将 API 载荷发送到 https://apidownload.looker.com/download。API 载荷必须包含 lic、email 和 latest 的值。

latest 属性表示 Looker JAR 的版本。如需下载当前 Looker 版本 (looker-latest.jar) 的最新版 JAR 文件，只需指定 "latest" 即可。如需下载特定版本，请将 latest 设置为 "specific"，并在 API 载荷中添加另一个键值对，该键值对名为 specific，其值为核心 JAR 文件名。

您只需调用一次 API；初始响应将包含两个下载链接，并且在 10 分钟内有效。您需要分别下载这两个 JAR 文件。

以下是使用 ES6 (JavaScript) 编写的请求的两个示例。如需请求最新版本，请执行以下操作：

    axios({
        url: "https://apidownload.looker.com/download",
        method: "post",
        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "latest"
        }
    }).then(function (response) {
        console.log(response.data);
    })

如需请求特定 JAR 版本（例如 Looker 22.2），请执行以下操作： none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

以下是两个向 HTTPS 端点发出 POST 请求的 shell 命令示例。

如需使用 wget 命令请求特定版本的 JAR 文件（例如 Looker 22.2），请执行以下操作：

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

如需使用一系列 curl 和 wget 命令请求最新的 JAR 文件，以在本地下载并保存这些文件，请执行以下操作：

curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json
sed -i 1,12d api_response.json

wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"

wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"

或者，如果您已安装 jq 和 wget，则可以使用以下 shell 命令示例。

如需使用一系列 wget 命令请求最新的 JAR 文件，请执行以下操作：

wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"

wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"

您还可以通过在以下一系列命令示例中将 LOOKER_VERSION 设置为 latest、22.2-latest 或其他支持的版本来下载其他版本的 JAR。例如，如需请求 Looker 22.2 的核心文件和依赖项文件，请执行以下操作：

export LOOKER_VERSION="22.2-latest"

wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"

wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\
'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\
\"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"

API 载荷错误（例如输入参数缺失或输入错误）会导致“请求正文无效”响应。如果请求 specific 版本时提供的许可密钥不正确或省略了 specific 值，则会收到“请求无效”响应。

如果两个 JAR 文件都无法下载，splitJarMessage 字段中可能会显示一条消息。

如果您之前未接受最新的 EULA，则响应将包含三个字段：eulaMessage、eulaText 和 eulaNeeded。eulaMessage 表示您必须先通过下载 Looker JAR 文件 网页接受 EULA，然后 API 才会返回下载网址。