Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Make okhttp3.internal into `internal` or turn into API

Aperta
#9,435 2 commenti 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
30/100
Tipo di issue
Refactoring
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
kotlin
Ambito
api

Direzione di ricerca

Start by reviewing the okhttp3.internal package and the issue’s example, okhttp3.internal.Util.kt, to understand which symbols are public and how users may depend on them. The issue asks for a project-wide API stance; done means deciding which symbols should be Kotlin internal and which, if any, should be supported API.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

bug

Could you clarify the stance on using code from the okhttp3.internal package?

Is this code truly internal (as the package name suggests) in the sense that...

  • It does NOT belong to the API
  • It CAN be changed without notice between releases
  • OkHttp users should NOT directly reference anything from okhttp3.internal

If the above is true and okhttp3.internal is truly internal, could you please mark all of it with Kotlin internal?

The problem is that currently a lot of okhttp3.internal code is public and OkHttp users CAN reference it, which can then break on update. For example, utilities from the okhttp3.internal.Util.kt disappeared on update from OkHttp 4 to 5. This is especially a problem in big codebases with many engineers.

If there is some okhttp3.internal that needs to be accessed by OkHttp users, it might be a signal that it has to be a proper API instead.

Lingua principale
Kotlin
Stelle
47.1k
Fork
9.3k
Merge medio
1g 18h
PR unite (30g)
29

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di lysine-dev/okhttp

Tutte le issue di lysine-dev/okhttp

Issue simili

Altre issue su Kotlin

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.