GoogleCloudPlatform / GoogleCloudPlatform/cloud-opensource-java

Document how to treat ordering of members in BOM

未關閉
#311 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
documentation enhancement p3
主要語言
Java
星號
163
分支
80
PR 合併指標
30 天內沒有已合併 PR

描述

Document how to treat ordering of members in BOM. Users may pick up arbitrary order of BOM members.

Assume there's A, B and C in BOM where
- Class path `A.jar:B.jar:C.jar` generates zero static linkage errors
- Class path `B.jar:A.jar:C.jar` generates 1 static linkage error

What should a static linkage check say about the situation?

# Option 0
Advice BOM users to follow an order.

# Option 1
Run static linkage check on all permutation. Too expensive.

# Option 2
Given a reference, check all available jar files that contains the referent class. For each version of jar, check compatibility
This will generate false positives.

# Option 3
Round-robin table (pair-wise comparison) #168. Something similar to
[Cloud Opensource Python: Compatibility Grid](https://googlecloudplatform.github.io/cloud-opensource-python/grid.html)

Note that when we do pair-wise comparison, the dependency tree of each cell needs to use managed dependency as if it's fetching them via BOM.

![image](https://user-images.githubusercontent.com/28604/53898765-c0321580-4006-11e9-84b7-d4572fdc3464.png)

貢獻指南

開啟貢獻指南

評估

這個 Issue 還沒有評估資料。

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。