ניפוי באגים ותיקון שגיאות רישום
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
לפעמים הפונקציה Tink יוצרת הודעות שגיאה כמו
No wrapper registered for typeNo manager for type T has been registeredUnable to get primitive interface P for key of type T
הדף הזה עוזר לנפות באגים בבעיות כאלה.
מקרה 1: השגיאה מסומנת בכוכב עם הכיתוב 'לא נמצא wrapper' או תוכן דומה.
מתבצעת קריאה ל-GetPrimitive() כדי לקבל סוג פרימיטיבי שלא נרשם. בדרך כלל, מתקנים את הבעיה על ידי קריאה ל-TinkConfig.register() במקום כלשהו מוקדם יותר בקובץ הבינארי. מספיק להירשם פעם אחת, ואפשר לעשות זאת בהתחלה.
חלק מהפרימיטיבים זקוקים לרישום מיוחד יותר.
- נדרש
KeyDerivationConfig.register() לשימוש ב-KeysetDeriver
- נדרש
JwtMacConfig.register() לשימוש ב-JwtMac
- ל-
JwtPublicKeySign ול-JwtPublicKeyVerify נדרש
JwtSignatureConfig.register()
מקרה 2: השגיאה מציינת סוג מפתח ופרימיטיבי.
לדוגמה, ייתכן שהודעת השגיאה Unable to get primitive interface P for key
of type T עבור ערך ספציפי מסוים של P ו-T.
במקרה הזה, Tink לא יכולה ליצור את הפרמיטיב הספציפי שביקשתם לערכת המפתחות שיש לכם. בדרך כלל הסיבה לכך היא שיש לכם קבוצת מפתחות מסוג שגוי. לדוגמה, יכול להיות שביקשתם Mac, אבל ערכת המפתחות היא ל-Aead.
אחד מהמקרים הנפוצים הוא ניסיון להשיג מפתח ציבורי פרימיטיבי ממערך מפתחות שמכיל מפתחות פרטיים. כדי לבדוק אם זו הבעיה, כדאי במקום זאת לקרוא ל-GetPrimitive() מתוך התוצאה של GetPublicKeysetHandle().
אם זה לא פותר את הבעיה, תוכלו למצוא רשימה עדכנית של סוגי המפתחות כאן, בבדיקות של כל השפות. צריך לבדוק אם ה-P הפרמיטיבי מופיע יחד עם סוג המפתח T.
אם המפתח הראשוני מופיע עם סוג המפתח המתאים, יכול להיות שיישום Tink של השפה שלכם לא תומך בסוג המפתח T. ברשימת סוגי המפתחות אפשר לבדוק אם Tink תומך בסוג המפתח בשפה שלכם.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eTink error messages like "No wrapper registered" often indicate missing primitive registration, fixable with \u003ccode\u003eTinkConfig.register()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eErrors mentioning key type and primitive usually mean an incompatible keyset is used, like requesting a Mac with an Aead keyset.\u003c/p\u003e\n"],["\u003cp\u003ePublic key primitives require keysets obtained via \u003ccode\u003eGetPublicKeysetHandle()\u003c/code\u003e to avoid key type mismatches.\u003c/p\u003e\n"],["\u003cp\u003eVerify key type and primitive compatibility by checking the cross-language test resources and supported key types documentation for your language.\u003c/p\u003e\n"]]],["Tink error messages like \"No wrapper registered\" or \"Unable to get primitive\" indicate issues with key and primitive type registration or compatibility. For \"No wrapper\" errors, register the type using `TinkConfig.register()` or specialized methods like `KeyDerivationConfig.register()`. For primitive-key type mismatches, verify that the keyset's type matches the requested primitive, and use `GetPublicKeysetHandle()` for public keys. Check supported key type lists if registration or type-checking does not fix the issue.\n"],null,["# Debug Registration Errors\n\nTink sometimes produces error messages such as\n\n- `No wrapper registered for type`\n- `No manager for type T has been registered`\n- `Unable to get primitive interface P for key of type T`\n\nThis page helps to debug such issues.\n\nCase 1: The error stars with \"No wrapper found\" or similar.\n-----------------------------------------------------------\n\nYou are calling `GetPrimitive()` to get a primitive type that has not been\nregistered, which is generally fixed by calling `TinkConfig.register()`\nsomewhere earlier in the binary. Registering once suffices and can be done at\nstartup.\n\nSome primitives need more specialized registration.\n\n- `KeysetDeriver` requires `KeyDerivationConfig.register()`\n- `JwtMac` requires `JwtMacConfig.register()`\n- `JwtPublicKeySign` and `JwtPublicKeyVerify` require `JwtSignatureConfig.register()`\n\nCase 2: The error lists a key type and a primitive.\n---------------------------------------------------\n\nFor example, the error might say `Unable to get primitive interface P for key\nof type T` for some specific value of P and T.\n\nIn this case, Tink is unable to create the specific primitive you asked it\nfor the keyset you have. Typically, this happens because you have a keyset\nfor the wrong type. For example, you might be asking for a Mac, but the keyset\nis for Aead.\n\nOne common case is that one tries to get a public key primitive from a keyset\ncontaining private keys. To see if this is the problem, consider calling\n`GetPrimitive()` on the result of `GetPublicKeysetHandle()` instead.\n\nIf this does not help, an up to date list of the key types can be found\n[here](https://github.com/tink-crypto/tink-cross-lang-tests/blob/main/cross_language/cross_language/tink_config/_key_types.py),\nin our [cross language tests](https://github.com/tink-crypto/tink-cross-lang-tests/blob/main/cross_language/cross_language). You should check if the primitive P is listed\ntogether with the key type T.\n\nIf the primitive is listed with the corresponding key type, it may be that\nthe Tink implementation of your language does not support key type T. Check the\n[list of key types](/tink/supported-key-types) to see if Tink supports your key\ntype in your language."]]
