下载 Looker JAR 文件

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

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

您必须先按照本页中的规范接受最终用户许可协议 (EULA)，然后才能下载 JAR 文件。您可以在下载 Looker JAR 文件网页上找到该协议。下载 JAR 文件的每位用户只能接受一次此最终用户许可协议。（如果此 EULA 日后更新，每位用户也必须接受更新后的版本。）

使用下载 Looker JAR 文件网页

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

  1. 输入您的 Looker 许可证号。
  2. 输入您的电子邮件地址。该域名必须是私密托管的电子邮件域名。

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

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

  4. 点击获取下载内容。

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

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

调用 API

您必须先通过 下载 Looker JAR 文件网页接受 EULA，然后才能通过调用 API 下载 JAR 文件。

然后，您可以使用任何所需方法（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 将指明您必须先通过 Download Looker JAR file 网页接受 EULA，然后 API 才会返回下载网址。