API-versionering og ABI-stabilitet
Planlæg semantisk versionering, og beskyt ABI-stabiliteten på tværs af udgivelser
API-versionering og ABI-stabilitet er en gratis C++ Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i C++ Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. C++ Academy-kurset indeholder 4 lektioner i alt.
To forskellige former for kompatibilitet
To kompatibilitetsproblemer:
- API-kompatibilitet — kildekode, der kompilerer mod version N, kompilerer også mod N+1
- ABI-kompatibilitet — binærfiler, der er kompileret mod version N, fungerer med version N+1 uden at blive kompileret igen
Hvorfor ABI betyder noget
ABI-kompatibilitet gør det muligt at opgradere delte biblioteker uden at kompilere afhængige programmer igen. Det er afgørende for distributioner, plugins og langvarige programmer.
Hvad bryder ABI
Mange ændringer, der ser harmløse ud, bryder ABI:
- Tilføjelse, fjernelse eller omarrangering af datamedlemmer
- Tilføjelse eller fjernelse af virtuelle funktioner
- Ændring af nedarvning
- Ændring af skabelonparametre
- Ændringer i inline-funktioner (nogle gange)
Semantisk versionsstyring (SemVer)
Kommunikér kompatibilitet gennem versionsnumre MAJOR.MINOR.PATCH:
- MAJOR — ændringer, der bryder kompatibiliteten
- MINOR — nye funktioner, bagudkompatible
- PATCH — rettelser
Versionsmærkning i headerfiler
Angiv versionsmakroer i dine headerfiler.
#define MYLIB_VERSION_MAJOR 2
#define MYLIB_VERSION_MINOR 1
#define MYLIB_VERSION_PATCH 3SONAME til delte biblioteker
På Linux har delte biblioteker et SONAME, der indeholder hovedversionen. Sammenkædere og indlæseren bruger det til at finde kompatible versioner.
# libmylib.so.2 -> libmylib.so.2.1.3
# SONAME = libmylib.so.2Skjul implementeringsdetaljer
Stabile ABI'er kræver, at implementeringen holdes ude af headerfilerne. Brug PIMPL (i næste lektion) til at tilføje eller fjerne private medlemmer uden at påvirke brugerne.
Kompilatorens ABI
C++-ABI'en varierer mellem kompilatorer (GCC og MSVC bruger forskellig navnemangling og forskellige klasselayouts). Distribuér binærfiler, der er bygget med bestemte kompilatorer, eller hold dig til grænseflader med extern "C".
Standardbibliotekets ABI
Standardbiblioteket kan også bryde ABI'en — selv om libstdc++ og libc++ har politikker for det. Undgå std-typer i din stabile offentlige API, hvis du har brug for kompatibilitet på tværs af versioner.
Tilføj funktioner uden kompatibilitetsbrud
Sikre tilføjelser:
- Nye frie funktioner
- Nye klasser
- Nye ikke-virtuelle medlemsfunktioner (med omtanke)
Usikkert: at ændre klasser, som brugerne har på stakken eller har kompileret ind.
Værktøjer til kontrol af ABI
Værktøjer, der sammenligner to builds:
- abidiff — sammenligner ABI
- abicompliance-checker — genererer rapporter
Langsigtet strategi
Design med stabilitet for øje fra starten: en lille offentlig API, uigennemsigtige typer og omhyggelig brug af skabeloner og nedarvning. Når du først har udgivet noget, er det dyrt at bryde ABI'en — begræns større versionsspring, og kommunikér tydeligt.
Hurtigt tjek
Hvilken ændring i en C++-klasse vil sandsynligvis bryde ABI'en?
Opsamling
API-kompatibilitet betyder kildekompatibilitet, mens ABI-kompatibilitet betyder binærkompatibilitet. ABI'en er skrøbelig — tilføjelse af medlemmer eller virtuelle funktioner samt ændring af nedarvning bryder den. Brug SemVer, skjul implementeringen med PIMPL, udgiv flere hovedversioner side om side, og kør ABI-kontrolværktøjer.
Lær C++ med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 51
- Lektioner
- 203
Ofte stillede spørgsmål
Er lektionen “API-versionering og ABI-stabilitet” gratis?
Ja — alle 3 lektioner i læringssporet C++ Academy, inklusive “API-versionering og ABI-stabilitet”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. C++ Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “API-versionering og ABI-stabilitet”?
Planlæg semantisk versionering, og beskyt ABI-stabiliteten på tværs af udgivelser Du øver dig i C++ Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på C++ Academy?
Der kræves ingen tidligere erfaring. C++ Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.
Hvor lang tid tager lektionen “API-versionering og ABI-stabilitet”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne C++ Academy-lektion?
Ja. Alle C++ Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Header-only kontra kompilerede biblioteker
- API-versionering og ABI-stabilitet
- Skjul implementering med PIMPL
- Skrivning af et moderne header-only-hjælpebibliotek