下载 Looker JAR 文件

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

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

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

使用下载 Looker JAR 文件网页

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

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

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

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

  4. 点击获取下载。

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

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

调用 API

您必须先通过下载 Looker JAR 文件网页接受最终用户许可协议，然后才能通过调用该 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 字段中显示消息。

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