diff options
| author | Saša Živkov <sasa.zivkov@sap.com> | 2020-07-30 17:43:42 +0200 |
|---|---|---|
| committer | Saša Živkov <zivkov@gmail.com> | 2020-08-03 08:15:28 +0000 |
| commit | f5f0d61a80de41c118c4f719ae992ba417d6e942 (patch) | |
| tree | ce31927ecf5b43644a7d7a6a40496ce085dcc566 | |
| parent | 635d92db8012ffcc20dcf1d7e3163901cfa623a4 (diff) | |
Document how to mitigate the issue of broken Eclipse project on MacOS
Change-Id: I94d0e113205a7fea0aeb4976d3898d4d5afac408
| -rw-r--r-- | Documentation/dev-eclipse.txt | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt index daabbf3c57..e1b3e9e094 100644 --- a/Documentation/dev-eclipse.txt +++ b/Documentation/dev-eclipse.txt @@ -42,6 +42,37 @@ that get saved to the `.project` file, for example adding Resource Filters on a folder, they will be overwritten the next time you run `tools/eclipse/project.py`. +=== Eclipse project on MacOS + +By default, bazel uses `/private/var/tmp` as the +link:https://docs.bazel.build/versions/master/output_directories.html[outputRoot on MacOS]. +This means that the eclipse project will reference libraries stored under that directory. +However, MacOS runs periodic cleanup task which deletes the content under `/private/var/tmp` +which wasn't accessed or modified for some days, by default 3 days. This can lead to a broken +Eclipse project as referenced libraries get deleted. + +There are two possibilities to mitigate this issue. + +==== Change the location of the bazel output directory +On Linux, the output directory defaults to `$HOME/.cache/bazel` and the same can be configured +on Mac too. Edit, or create, the `$HOME/.bazelrc` file and add the following line: +---- +startup --output_user_root=/Users/johndoe/.cache/bazel +---- + +==== Increase the treshold for the cleanup of temporary files +The default treshold for the cleanup can be overriden by creating a configuration file under +`/etc/periodic.conf` and setting a larger value for the `daily_clean_tmps_days`. + +An example `/etc/periodic.conf` file: + +---- +# This file overrides the settings from /etc/defaults/periodic.conf +daily_clean_tmps_days="45" # If not accessed for +---- + +For more details about the proposed workaround see link:https://superuser.com/a/187105[this post] + === Eclipse project with custom plugins === To add custom plugins to the eclipse project add them to `tools/bzl/plugins.bzl` |