如何在Bazel中启用doclint
在Bazel中启用doclint是指在使用Bazel构建项目时，开启对文档注释的静态检查功能。doclint可以帮助开发者在编译过程中检测文档注释中的错误和潜在问题，提高代码的可读性和可维护性。
要在Bazel中启用doclint，可以按照以下步骤进行操作：
- 确保已经安装了Bazel，并且项目已经使用Bazel进行构建。
- 在项目的根目录下创建一个名为
.bazelrc的文件，如果已经存在该文件，则直接编辑该文件。 - 在
.bazelrc文件中添加以下内容：
build --experimental_doclint这个配置项会启用Bazel的实验性doclint功能。
- 保存
.bazelrc文件并退出编辑器。 - 在终端中进入项目的根目录，并执行构建命令，例如：
bazel build //...这个命令会使用Bazel构建整个项目。
- 在构建过程中，Bazel会对文档注释进行静态检查，并输出相关的警告或错误信息。
启用doclint可以帮助开发者及时发现文档注释中的问题，提高代码的质量和可维护性。在Bazel中启用doclint后，可以根据输出的警告或错误信息进行修复，并确保文档注释的准确性和一致性。
腾讯云相关产品和产品介绍链接地址：
- 腾讯云官网：https://cloud.tencent.com/
- 云服务器（CVM）：https://cloud.tencent.com/product/cvm
- 云原生应用引擎（TKE）：https://cloud.tencent.com/product/tke
- 云数据库 MySQL 版（TencentDB for MySQL）：https://cloud.tencent.com/product/cdb_mysql
- 云存储（COS）：https://cloud.tencent.com/product/cos
- 人工智能（AI）：https://cloud.tencent.com/product/ai
- 物联网（IoT）：https://cloud.tencent.com/product/iot
- 移动开发（移动推送、移动分析、移动测试等）：https://cloud.tencent.com/product/mobile
- 区块链（BCS）：https://cloud.tencent.com/product/bcs
- 元宇宙（Tencent XR）：https://cloud.tencent.com/product/xr
相关·内容
我最近将我的项目从Java 7升级到了8。由于javadoc的doclint特性，我偶然发现了一些错误。错误:此处不允许标记：
java文件中的HTML标记：
<a name="ThpSslEnabled"></a>
我试着检查锚标记是否符合W3C HTML标准，但是没有发现任何可能有用的东西。
浏览 2提问于2015-11-03得票数 6
回答已采纳
我有一个带有src/main/java/test/Test.java的简单项目
package test;
/**
* Class java doc
*/
public class Test
{
/**
* Wrong java doc
*
* @param test
* @return
*/
public int aMethod(int param){
return 0;
}
}
和pom.xml
<?xml version="1.0" encoding="UTF-
浏览 0提问于2018-07-09得票数 2
回答已采纳
我正在尝试将现有的Javadoc修复到project中。 我正在运行mvn javadoc:fix。它可以成功执行，但不能修复某些Javadoc。 Maven Javadoc插件的配置： [DEBUG] Configuring mojo org.apache.maven.plugins:maven-javadoc-plugin:3.2.0:fix from plugin realm ClassRealm[plugin>org.apache.maven.plugins:maven-javadoc-plugin:3.2.0, parent: jdk.internal.loader.Clas
浏览 56提问于2020-08-06得票数 4
回答已采纳
具有默认的maven-javadoc插件配置：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>ja
浏览 4提问于2022-04-07得票数 2
我想为我的C++项目启用智能感知，该项目是用bazel在VS代码中构建的。 曾经有一个extension可以做到这一点，但自从官方vscode-bazel扩展发布后，它就停止了，因为它缺乏这一功能。
浏览 29提问于2020-04-04得票数 3
我必须在Windows平台上使用Bazel测试Go代码，以确保测试也能在Windows上通过。然而，我有一台Mac电脑。我已经尝试了VirtualBox/Vagrant设置，并共享了该目录。我也可以去那里上班。Bazel给出了一些与Visual Studio的版本冲突，但我对go test有一个变通办法。 有没有一个已知的用于Mac的Windows镜像已经有Golang，Bazel等所有设置，我可以简单地docker run或其他东西？
浏览 14提问于2021-02-02得票数 1
1回答
我正在使用Bazel (5.2.0)来构建一个emscripten应用程序。我的设置如下：
main.cpp
#include "emscripten.h"
#include <iostream>
int main(int argc, char **argv) {
throw std::runtime_error("error!");
}
BUILD.bazel
load("@rules_cc//cc:defs.bzl", "cc_binary")
load("@emsdk//emscripten_
浏览 15提问于2022-06-15得票数 0
回答已采纳
我有一个现有的bazel项目，可以通过Bazelv0.5.3成功编译。因为clion的插件只支持bazel 0.24.0+，所以我将bazel更新到最新版本。然而，当将项目加载到clion中时，clion会告诉" Error : Error tells工作区文件“。
是否有任何方法来更新旧的bazel项目？
浏览 2提问于2019-10-18得票数 0
回答已采纳
在重启ubuntu后直接运行我的c++ tensorflow应用程序有问题。
通常我通过bazel build构建应用程序。
bazel build -c opt --local_resources 3072,4.0,1.0 --verbose_failures --config=monolithic //tensorflow/app/...
在构建之后，当我执行
bazel-bin/tensorflow/app/run
一切都很完美，但是，当我重新启动ubuntu并首先执行bazel时，我收到了这个错误的垃圾邮件。
May 11 12:29:05 tegra-ubuntu start.sh[
浏览 0提问于2018-05-11得票数 0
回答已采纳
1回答
在我的WORKSPACE文件中，我定义了一个http_archive，如
http_archive(
name = "awscli_zip",
urls = [
"https://awscli.amazonaws.com/awscli-exe-linux-x86_64-{version}.zip".format(version = awscli_version)
],
sha256 = awscli_sha256,
build_file = "//third_party:BUILD.awscli&#
浏览 4提问于2022-05-19得票数 1
回答已采纳
1回答
我正在尝试部署，但当我试图：
curl http://bazel-remote.dev.azr.myhost.com:80/status
入口处的主人，我得到：
<html>
<head><title>308 Permanent Redirect</title></head>
<body>
<center><h1>308 Permanent Redirect</h1></center>
<hr><center>nginx</center>
浏览 2提问于2021-08-20得票数 3
回答已采纳
考虑以下BUILD文件：
load("@io_bazel_rules_go//go:def.bzl", "go_binary", "go_library")
cc_library(
name = "c",
srcs = [
"c.c",
"c.h",
],
hdrs = [
"c.h",
],
)
go_library(
name = "gl",
srcs =
浏览 0提问于2020-12-16得票数 0
我能够使用bazel命令生成coverage.dat文件：
bazel coverage //tests/... --instrumented_filter=/src[/:]
这会为其中一个类生成报告，因为coverage.dat文件是为不同目录中的每个检测文件分别生成的。如何获得合并的coverage.dat？
浏览 7提问于2017-09-22得票数 4
回答已采纳
这是代码结构
| //base_folder
├── file0.txt
├── BUILD
├── folder1
| ├── BUILD
| ├── file1
├── folder2
| ├── BUILD
| ├── file2
我想知道所有的文件或目标信息来做进一步的处理。
我可以使用bazel查询命令，但不能在BAZEL规则实现中获得它们。
bazel查询类(cc_library，//.)
我试着用一般规则来执行命令。但是"bazel查询“不能在bazel-bin文件夹中使用。
我尝试了genquery，但是“//.”在genquery中不允许。
我有办
浏览 9提问于2022-01-20得票数 0
我正试图按照上的指南运行一个bazel命令，到目前为止，我一直没有成功。我正在使用Python版本3.5.0
使用指南正确安装和配置了Bazel，但没有效果。我总是收到同样的错误：
ERROR: in target '//external:cc_toolchain': no such package '@local_config_cc//': Traceback (most recent call last):
File "C:/users/username/appdata/local/temp/_bazel_username/ykvutwrt/
浏览 1提问于2017-09-12得票数 1
1回答
我试图获得以下场景的工作原型：
语言:铁锈(rustc 1.45.0-nightly (ad4bc3323 2020-06-01))
框架:火箭v0.4.4
构建工具: Bazel
平台: Mac /达尔文x64
运行bazel build //web-api会产生以下错误。我相信，基于查看Cargo.lock文件，这是因为Rocket对hyper库的依赖指定了对log 0.3.9库的依赖。不管出于什么原因，它没有使用最近的log=0.4.x。尽管如此，我不知道它为什么要拉这个库，因为如果我手动构建它，它就能正常工作。
ERROR: /private/var/tmp/_
浏览 5提问于2020-06-07得票数 5
回答已采纳
即使在与Bazel同步后，这些文件在IntelliJ中仍显示为“未同步”。 我尝试过迁移到Bazel的前一个版本，但是没有用。 这里有什么建议吗？
浏览 62提问于2019-09-08得票数 3
1回答
我想在colab的一些项目中使用bazel builder。但是!bazel给了我/bin/bash: bazel: command not found。我试着用来安装它 BAZEL_VERSION = '0.20.0'
!wget https://github.com/bazelbuild/bazel/releases/download/{BAZEL_VERSION}/bazel-{BAZEL_VERSION}-installer-linux-x86_64.sh
!chmod +x bazel-{BAZEL_VERSION}-installer-linux-x86_64
浏览 100提问于2021-07-25得票数 1
是否可以将依赖项硬编码到使用bazel构建的库中。原因是，如果我构建了一些lib，我可以在工作空间中使用它，但一旦我将lib复制到其他地方，我就会释放所有依赖项(bazel缓存)。当我想要将库部署到系统中或安装时，切换会产生问题。 some_folder
|
thirdparty
|_WORKSPACE
|_somelib
| |_src
| |_ a.c
| |_ BUILD
| |_include
| |_a.h
|_include
|_ b.h
浏览 30提问于2019-03-02得票数 0
回答已采纳
我想使用bazel在使用Lustre文件系统的CentOS 6.6集群上构建tensorflow。此文件系统不支持锁定。。
我读过码头可以提供虚拟化。我是否可以使用不同的文件系统在坞内使用bazel？
浏览 2提问于2018-02-24得票数 0
回答已采纳
如何在python2环境中安装Bazel？tensorflow网站上发布了这样的错误：“注意:由于Bazel错误，我们只支持在python2环境中构建安卓演示应用程序”，(请参阅Windows上的相关Bazel安装“>Windows上的Bazel安装)。如何在python2环境中安装bazel (使用bazel)？在python2环境中安装Bazel可能是Tensorflow网站上之前显示的错误的变通方法，它们似乎没有任何其他已知的变通方法。
浏览 3提问于2018-09-13得票数 0
1回答
尝试用bazel和linux测试端口隔离，结果失败了。
我的env如下(从aws开始)：
$ cat /etc/*-release
PRETTY_NAME="Debian GNU/Linux 8 (jessie)"
NAME="Debian GNU/Linux"
VERSION_ID="8"
VERSION="8 (jessie)"
ID=debian
HOME_URL="http://www.debian.org/"
SUPPORT_URL="http://www.debian.org/support&#
浏览 3提问于2017-06-20得票数 2
回答已采纳
我是巴泽尔的新手。我不知道这东西是怎么工作的。在上，有关于“创建package并安装”的部分。
$ bazel build -c opt //tensorflow/tools/pip_package:build_pip_package
# To build with GPU support:
$ bazel build -c opt --config=cuda //tensorflow/tools/pip_package:build_pip_package
$ bazel-bin/tensorflow/tools/pip_package/build_pip_package /tmp/te
浏览 3提问于2016-02-16得票数 19
回答已采纳
我一直在尝试使用Bazel的新版本安装ONOS，即在Ubuntu20.04LTS中为mininet/mininet安装Bazel-5.1.1。我一直有关于命令的问题。我已经搜索了所有的安装过程，并尝试了很多。但也有类似的问题。是否有任何链接或文章，其中有一个明确的步骤，一步一步这样做？我有一个安装的任务，我需要在一个星期内完成。任何帮助都将不胜感激。提前谢谢。
我所犯的错误：
sendate@sendate04:~/onos$ bazel build onos
ERROR: The project you're trying to build requires Bazel 3.
浏览 19提问于2022-06-01得票数 0
我正在为Python项目使用Bazel。
我分析了一个琐碎的测试，使用bazel test //... --profile=/tmp/profile.gz运行的时间应该远远低于1s。但是，bazel test命令占用了5s。
分析结果如下所示
它显示，它大部分时间用于操作action 'Testing //tests/unit/io:test_ds_presto'，如在关键路径行中看到的那样。然后，我将通过bazel aquery了解更多关于这一行动的细节，
action 'Testing //tests/unit/io:test_ds_presto'
浏览 16提问于2021-01-30得票数 1
我有一个(纯粹的) Go项目是用Gazelle建立的。它有一个主要的二进制，它由Gazelle生成的cmd/main/BUILD如下所示：
load("@io_bazel_rules_go//go:def.bzl", "go_binary", "go_library")
go_library(
name = "main_lib",
srcs = ["main.go"],
importpath = "github.com/me/myrepo/....",
visibi
浏览 10提问于2022-02-18得票数 1
3回答
配置环境
、
bazel build --config cxx20 --config opts ...
我想默认为--config cxx20 --config opts。但是，我不能更改.bazelrc，因为其他用户使用不同的信任。是否有像BAZEL_CXXOPTS这样的配置环境变量？
export BAZEL_???="--config cxx20 --config opts"
浏览 6提问于2020-11-05得票数 0
回答已采纳
1回答
我正在尝试报告一个使用Bazel的项目的错误。作为问题报告的一部分，我想包含有关使用的C++编译器的信息。
我可以使用哪个命令来执行此操作？
bazel build -s //the_target告诉我external/local_config_cc/wrapped_clang似乎就是编译器。在bazel-<project>/...中我可以找到该路径，但是在其中运行可执行文件wrapped_clang只会导致中止。
浏览 3提问于2018-07-22得票数 2
我在python中有一个来自Keras的经过训练的模型，我想用TensorFlow1.2在C++中预测它。我似乎无法将tensorflow库放入我的c++程序中。有谁可以带我完成这些步骤吗？ii)我需要使用bazel吗?如果需要，使用bazel的步骤是什么？谢谢:)
浏览 1提问于2017-07-11得票数 0
我有两个shell脚本。一个(a)打印"Hello"，另一个(b)打印"World"。我想要一个Bazel目标(c)，它可以同时调用两个脚本并提供"Hello World"。 我的尝试是： mkdir BashScriptDemo
cd BashScriptDemo
touch WORKSPACE.bazel # empty WORKSPACE file
touch BUILD.bazel # empty BUILD file
mkdir my_package
cd my_package
echo '3.5.0' > .b
浏览 35提问于2020-09-24得票数 0
回答已采纳
我想将一个ant构建迁移到Bazel4.2.1。ant构建使用Eclipse编译器(ecj-3.27.0)。
在Bazel中声明Java编译器的方法是java_toolchain。
因此，我查看了bazel query @bazel_tools//tools/jdk:all的输出，并尝试使用香草工具链作为灵感(bazelisk query --output=build @bazel_tools//tools/jdk:toolchain_vanilla)。
java_toolchain(
# modified settings
name = "my-ecj-toolchain&#
浏览 9提问于2021-10-06得票数 0
我试图找出如何使用包括JavaScript在内的多种语言在工作空间中正确地使用bazel中的rollup_bundle()，并在不同的目录中定义多个npm包。
看起来，汇总bazel规则比我想要的更集中:在这个工作区的上下文中，我希望每个npm包管理自己的node_modules (参见可复制的WORKSPACE.bazel )。
小可复制(玩具例子)：
$ bazel build //js/alpha
Starting local Bazel server and connecting to it...
ERROR: /path/to/bazel-nodejs-rollup-multi-p
浏览 41提问于2022-04-22得票数 0
2回答
我试图使用VS 2017在Windows上构建Tensorflow 1.14，并启用了LTCG (链接时间代码生成)。我在建筑的半路上撞到了这架飞机：
external/bazel_tools/tools/def_parser/def_parser.exe bazel-out/x64_windows-opt/bin/tensorflow/contrib/layers/python/ops/_sparse_feature_cross_op.so.gen.def _sparse_feature_cross_op.so @bazel-out/x64_windows-opt/bin/tensorflo
浏览 0提问于2019-07-17得票数 1
我正在尝试分析和修复一个通常是绿色的薄片测试。
我的问题是，一旦测试通过，Bazel不会重新运行它，直到任何输入发生变化。
我看到你可以要求Bazel重新运行一个目标，但AFAICT直到它第一次是绿色的(也就是为了减轻一个不稳定的测试，而不是解决它)。
有没有办法让Bazel运行测试，即使它通过了？
我想要像bazel test --force-attempts=50 //my-package:my-target这样的东西
浏览 0提问于2017-06-25得票数 32
回答已采纳
OpenSuse似乎提供了bazel4.2包，不幸的是它是一个实验性/社区包，我不知道如何在基于opensuse的Dockerfile中启用这个提要。
Dockerfile：
FROM opensuse/tumbleweed
RUN zypper update -y \
&& zypper install -y bazel4.2
RUN bazel --version
观察到的
docker build --tag=plop .
...
Retrieving repository 'openSUSE-Tumbleweed-Non-Oss' metadata [
浏览 8提问于2022-04-12得票数 1
我仔细研究了选项和源代码，但仍然不确定如何调试bazel版本，特别是java。
另外，任何人都知道我如何更改bazel，在本地构建它，并在构建中使用它来验证。我找到了bazel调用: exec -a "$0“"${BAZEL_REAL}”"$@“
其中，BAZEL_REAL是二进制文件: /usr/local/Cellar/bazel/0.15.2/libexec/bin/bazel-real
但这并没有详细解释它是如何启动的，以及我如何调试它……
比如，在构建代码的同时，是否可以跳过并调试com.google.devtools.build.lib.bazel.rule
浏览 5提问于2018-10-13得票数 1
2回答
我是巴泽尔和柯南的新人。我尝试在bazel中运行conan，使用它
在WORSPACE文件中：
load("//third-party/grpc:direct.bzl", "load_conan_dependencies")
在direct.bzl中
load("@//conandeps:dependencies.bzl", "load_conan_dependencies")
conanfile.txt
[requires]
grpc/1.45.2
[generators]
cmake
当我尝试bazel同步时，会有消息：
E
浏览 12提问于2022-05-05得票数 1
回答已采纳
4回答
我尝试设置一个使用 (0.26.0)的Azure构建管道。
我的管道YAML定义文件如下所示：
trigger:
- master
pool:
vmImage: 'windows-2019'
steps:
- script: echo Hello, world!
displayName: 'Run a one-line script'
- script: |
bazel version
echo Add other tasks to build, test, and deploy your project.
echo See
浏览 0提问于2019-05-30得票数 2
回答已采纳
我试图在Windows机器上构建bazel，但是bazel build //src:bazel没有找到任何要构建的目标：
$ bazel build //src:bazel
Loading:
Loading: 0 packages loaded
INFO: Analysed 0 targets (0 packages loaded).
INFO: Found 0 targets...
[0 / 1] [-----] BazelWorkspaceStatusAction stable-status.txt
INFO: Elapsed time: 0.389s, Critical Path: 0.
浏览 0提问于2018-02-23得票数 2
回答已采纳
有没有办法为bazel项目使用eclise，有指南。用于Bazel的Eclipse插件，但我在安装时找不到Eclipse 4 Bazel
浏览 19提问于2018-02-03得票数 0
我使用git的“工作树”功能来管理我的回购工具的分支。这意味着每个活动分支都位于自己的目录中，切换分支是通过切换目录来完成的。
不幸的是，这似乎与bazel发生了严重的交互作用。即使使用共享磁盘缓存，我也发现bazel为每个工作树目录从我的工作区文件中重新下载远程存储库(可能是因为远程操作)。其中有些很大，而且很慢。(我可以安装一个squid代理，但我觉得bazel的缓存应该足够了)。
我已经找到了，但没有解决方案。
我确信其他用户正在使用bazel和git工作树解决方案。其他用户可以提供什么建议？其他用户发现了什么bazel配置可以改善这种情况？
浏览 28提问于2022-07-18得票数 0
我想使用Gazelle来管理我在Bazel中的Go依赖项(及其依赖项)。运行bazel run //:gazelle update-repos firebase.google.com/go将适当配置的go_repository添加到我的WORKSPACE文件中：
go_repository(
name = "com_google_firebase_go",
importpath = "firebase.google.com/go",
sum = "h1:3TdYC3DDi6aHn20qoRkxwGqNgdjtblwVAyRLQwG
浏览 6提问于2022-02-16得票数 4
回答已采纳
我有一个Bazel项目(新的tcmalloc)，我正在尝试将它集成到一个典型的GNU Make项目中，该项目使用它自己的编译器/libc++构建。我们的目标是不分叉上游项目。
如果我正确地将所有C++选项传递给bazel (其中一组是-nostdinc++ -I<path to libc++>)，那么Bazel就是uhappy The include path '/home/vlovich/myproject/deps/toolchain/libc++/trunk/include' references a path outside of the execution
浏览 2提问于2021-04-16得票数 0
我正在使用bazel从源代码构建tensorflow，如下所述：https://www.tensorflow.org/install/install_sources
在安装文档之后，我成功地编译了以下内容：
bazel build -c opt --copt=-mavx --copt=-mavx2 --copt=-mfma --copt=-mfpmath=both \
--cxxopt="-D_GLIBCXX_USE_CXX11_ABI=0"--config=cuda \
-k //tensorflow/tools/pip_package:build_pip_package
接
浏览 5提问于2017-08-25得票数 4
回答已采纳
我想按bazel查询所有gtest案例，
参数"--gtest_filter“只能与"bazel test”cmd一起使用
我正在尝试使用"bazel查询bazel查询//xxx:all"，但它会显示构建文件中定义的测试列表，我想从xxx.cc文件中获取案例列表。
浏览 26提问于2021-03-09得票数 1
我试图分析tensorflow的op内核的预处理源。我尝试了以下命令行，该命令行是根据一般构建说明改编的：
bazel build --config=opt --config=cuda //tensorflow/tools/pip_package:build_pip_package --save_temps
它的构建是正确的，但是从文档中，我期待着-H / -S传递给编译器的另一个传递。我不确定是否发生了这种情况，但我在缓存文件夹中找不到任何文件的.i、.ii或.s文件，只有少数几个文件(我看到了用于swig的.i文件和用于boringssl和nsync的.s文件)，尽管我确实为python
浏览 2提问于2018-06-24得票数 1
回答已采纳
Bazel正在尝试下载python test上的包。我已经编写了一段简单的python代码，并编写了一个测试文件对其进行测试。我正在运行`bazel test //test:python-test，我得到以下错误: /Path/to/build/external/bazel_tools/tools/jdk/build:305:1:没有这样的包'@remotejdk_linux//'：java.io.IOException:错误下载[未知主机: mirror.bazel.build，并被'@bazel_tools//tools/jdk:remote_jdk‘引用现在，这
浏览 25提问于2019-01-30得票数 3
当我想使用bazel转换我的模型时，我遇到了一些问题。
我尝试这个cmd：
$ bazel build tensorflow/tools/graph_transforms:transform_graph
以下是错误：
错误:跳过'tensorflow/tools/graph_transforms:transform_graph'：没有这样的包‘tensorflow/tools/graph’：在包路径上找不到构建文件
有人能告诉我怎么用吗？非常感谢
然后我尝试这个cmd：
$ bazel build tensorflow/tools/graph_transforms:v
浏览 0提问于2019-04-20得票数 1
我无法将多个库归档到单个库中，例如： cc_library(
name = "lib1",
srcs = ["src1.c"]
)
cc_library(
name = "lib2",
srcs = ["src2.c"]
)
cc_library(
name = "release-lib",
srcs = [":lib1",":lib2"] 当我运行bazel build //release-lib时，它将通过INFO: Found 1 target...target //re
浏览 42提问于2021-10-12得票数 0
我们正在考虑从Make迁移到Bazel。为了简化转换，我希望让bazel test (没有标志/选项)运行当前目录的测试(如果有的话)。
因此，bazel test my_tests bazel test将找到当前目录的BUILD文件，查找任何*_test规则并运行这些规则。
浏览 0提问于2018-03-29得票数 3
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
腾讯会议
实时音视频活动推荐
腾讯云开发者
