GoogleCloudPlatform / GoogleCloudPlatform/cloud-opensource-java

Document how to treat ordering of members in BOM

Aperta
#311 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
documentation enhancement p3
Lingua principale
Java
Stelle
163
Fork
80
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

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)

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.