انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

حِزم SDK

SDK جافا

تقيّم الحزمة io.nanoflags:nanoflags-java الأعلام محليًا ودون أي عملية إدخال/إخراج، على إعداد موقّع في الذاكرة تُبقيه محدّثًا في الخلفية عبر الاتصال الحي. ولا ترمي القراءات استثناءً ولا تحجب التنفيذ أبدًا، ويمكن مشاركة عميل واحد بأمان بين الخيوط.

التثبيت

build.gradle.kts
dependencies {
    implementation("io.nanoflags:nanoflags-java:0.2.0")
    implementation("io.nanoflags:nanoflags-java-openfeature:0.2.0")   // optional: OpenFeature provider
}
pom.xml
<dependency>
  <groupId>io.nanoflags</groupId>
  <artifactId>nanoflags-java</artifactId>
  <version>0.2.0</version>
</dependency>
  • منشورة على Maven Central باسم io.nanoflags:nanoflags-java 0.2.0 وio.nanoflags:nanoflags-java-openfeature 0.2.0. تتطلب Java 11 أو أحدث (مختبَرة على 11 و17 و21).
  • بلا اعتماديات وقت التشغيل: يستخدم HTTP وWebSocket المكتبة java.net.http المضمّنة في JDK. ويُستخدم مزوّد Ed25519 في JDK على Java 15 فأحدث، ومتحقِّق RFC 8032 مدمج على Java 11 إلى 14.
  • الحزمتان io.nanoflags.server (العميل) وio.nanoflags.server.openfeature (المزوّد). والمحرك في io.nanoflags.server.engine نقلٌ لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى.
  • برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/java. أما تطبيقات Android فتستخدم SDK لـ Android وKotlin (مفاتيح العميل، ودورة حياة التطبيق، وCompose).

البدء السريع

انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. وسجّل مستمع الأخطاء مباشرة بعد إنشاء العميل، قبل انتظار الجاهزية.

App.java
import io.nanoflags.server.NanoFlagsClient;
import io.nanoflags.server.NanoFlagsOptions;
import java.time.Duration;
import java.util.Map;

NanoFlagsClient flags = NanoFlagsClient.create(
    System.getenv("NANOFLAGS_SDK_KEY"),                          // nf_srv_… (server view)
    NanoFlagsOptions.builder().service("checkout-api").build());  // shown in "which revision is each service running"

flags.onError(e -> log.warn("nanoflags {}: {}", e.code(), e.getMessage()));

if (!flags.waitForReady(Duration.ofSeconds(5))) {                // never throws
    log.warn("flags not loaded yet ({}): evaluations return their fallbacks", flags.lastError());
}

Map<String, Object> user = Map.of("key", "user-42", "plan", "pro", "country", "SA");
if (flags.boolVariation("new-checkout", user, false)) {
    // ...
}

flags.close();                                                    // on shutdown (it is AutoCloseable)
  • أنشئ عميلًا واحدًا لكل مفتاح SDK عند بدء التشغيل وشاركه، فهو آمن للاستخدام من عدة خيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة https://edge.nanoflags.io.
  • يبدأ العميل التحميل فور عودة create، فقد يصل خطأ المحاولة الأولى قبل تسجيل مستمعك؛ لكن lastError() يحمل دائمًا آخر خطأ.
  • تعمل مفاتيح المتصفح (nf_pub_…) أيضًا لكنها لا ترى إلا الأعلام المكشوفة للعميل. ولا ترمي create الاستثناء NanoFlagsException (بالرمز CONFIG) إلا لمفتاح فارغ أو عنوان أساسي ليس http(s).

القراءات المُنمَّطة

كل دالة قراءة تأخذ مفتاح العلم والسياق والقيمة الاحتياطية. والسياق من النوع Map<String, ?>؛ و"key" هو الهوية المستخدمة في الطرح بالنسب المئوية. ويمكن أن تكون القيم نصوصًا أو قيمًا منطقية أو أي Number أو null أو مجموعات أو مصفوفات أو خرائط.

java
boolean enabled = flags.boolVariation("new-checkout", user, false);
String  accent  = flags.stringVariation("accent", user, "blue");
double  ratio   = flags.doubleVariation("sample-ratio", user, 0.1);
int     limit   = flags.intVariation("rate-limit", user, 100);
long    quota   = flags.longVariation("quota-bytes", user, 1_000_000L);
Object  layout  = flags.jsonVariation("layout", user, Map.of("cols", 3));   // null, Boolean, Double, String, List, Map

Map<String, Object> every = flags.allFlags(user);                           // records no telemetry
الدالةتعيد
boolVariation(key, context, fallback)قيمة boolean
stringVariation · doubleVariationقيمة String، أو double منتهية
intVariation · longVariationعددًا صحيحًا
jsonVariation(key, context, fallback)بيانات جافا عادية: null أو Boolean أو Double أو String أو List أو Map (بترتيب الإعداد)
jsonValueVariation(key, context, fallback)القيمة نفسها ككائن JsonValue بأنواع جافاسكريبت
…VariationDetail(key, context, fallback)كائن EvaluationDetail<T>، انظر التفاصيل والأسباب
evaluate(key, context, fallback)نتيجة المحرك دون فحص للنوع
allFlags(context) · allFlagsDetail(context)كل أعلام الإعداد المحمَّل (دون قياس)

تحصل على قيمتك الاحتياطية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر (السبب FLAG_NOT_FOUND أو ERROR). والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له.

التفاصيل والأسباب

java
EvaluationDetail<Boolean> d = flags.boolVariationDetail("new-checkout", user, false);
d.value();       // true
d.reason();      // RULE_MATCH
d.ruleId();      // "beta"
d.revision();    // 63
d.trace().forEach(step -> System.out.println(step));   // the same steps the dashboard shows
الدالةالمعنى
value()القيمة المقدَّمة (قيمتك الاحتياطية في حالات الاحتياط).
reason()RULE_MATCH، DEFAULT (لم تطابق قاعدة)، OFF (العلم معطّل)، FLAG_NOT_FOUND، ERROR (نوع خاطئ أو إعداد مشوّه)
ruleIndex() · ruleId()القاعدة المطابقة (فهرس يبدأ من الصفر، و-1 إن لم توجد) ومعرّفها.
inRollout() · bucket()للطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99).
revision()نسخة الإعداد التي جاءت منها النتيجة.
trace()قائمة من TraceStep تشرح القرار خطوة بخطوة.
error()لماذا كان reason() هو ERROR.

التحديثات الحيّة والمستمعات

يفتح العميل اتصال WebSocket واحدًا إلى wss://edge.nanoflags.io/v1/live (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا). وتدفع الحافة كل نسخة منشورة موقّعةً مسبقًا؛ فيتحقق منها العميل ويستبدلها ذرّيًا.

java
Subscription sub = flags.onChange(e ->
    log.info("now on r{} (was r{}) via {}", e.revision(), e.previousRevision(), e.transport()));

flags.onStatus(s -> log.info("nanoflags status: {}", s));   // NOT_READY, READY or STALE

sub.close();                                                // unregister
الدالةالمعنى
revision() · previousRevision()النسخة الجديدة والنسخة التي حلّت محلها (-1 للأولى).
checksum()المجموع الاختباري للإعداد الجديد ("" إن لم يكن معروفًا، كحزمة التهيئة المسبقة).
source()NETWORK أو STORE أو BOOTSTRAP
transport()LIVE (مدفوعة)، أو STREAM (جُلبت بعد إشعار من أحداث الخادم)، أو POLL
latency()قيمة Optional<Duration> من لحظة الحفظ في قاعدة البيانات إلى هذا الحدث، للنسخ المدفوعة التي تحمل وقت حفظها. وهي تقارن بين ساعتين.
  • تعمل المستمعات واحدًا تلو الآخر، بالترتيب، على خيط تابع للعميل. اجعلها قصيرة؛ والمستمع الذي يرمي استثناءً لا يعطّل العميل أبدًا. وكل دالة on… تعيد Subscription تغلقه لإلغاء التسجيل.
  • البدائل: إن تعذّر فتح المقبس يستخدم العميل أحداث الخادم (/v1/stream) ويستطلع /v1/bundle مع ETag كل 30 ثانية. وما دام المقبس سليمًا يعمل استطلاع احتياطي كل 5 دقائق. وتتباعد محاولات إعادة الاتصال من ثانية واحدة حتى 5 دقائق مع تذبذب عشوائي. وانظر وسائل النقل لتفاصيل البروتوكول.
  • لا تحلّ إجابة HTTP أقدم محل نسخة مدفوعة أبدًا، ولا تعيد إجابةٌ من الحافة موسومة بـ X-NanoFlags-Stale العميلَ إلى الوراء.

الجاهزية والحالة

java
flags.ready().thenAccept(ok -> log.info("configuration in use: {}", ok));   // CompletableFuture<Boolean>, never fails

flags.status();      // NOT_READY | READY | STALE
flags.revision();    // revision in use, or -1
flags.transport();   // LIVE | STREAM | POLL
flags.lastError();   // the error of the last failed request, or null
  • يكتمل ready() حين تنتهي محاولة التحميل الأولى: true إن كان هناك إعداد قيد الاستخدام. وwaitForReady(Duration) ينتظر تلك المدة على الأكثر. ولا يرمي أيٌّ منهما استثناءً.
  • READY: الإعداد معروف أنه محدّث. STALE: هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث (استُعيد من المخزن، أو تعذّر الوصول إلى الحافة، أو حُذفت البيئة). NOT_READY: لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الاحتياطية.
  • لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند بدء التشغيل بمهلة قصيرة، ودع قيمك الاحتياطية تغطي الباقي.

آخر إعداد سليم والتهيئة المسبقة

بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح status() بقيمة STALE).

java
import io.nanoflags.server.FileStore;
import java.nio.file.Files;
import java.nio.file.Path;

NanoFlagsOptions options = NanoFlagsOptions.builder()
    .service("checkout-api")
    .store(new FileStore(Path.of("/var/cache/app/flags.json")))   // keep the last good bundle across restarts
    .build();

// Or start from a bundle you ship, served until the edge answers:
NanoFlagsOptions offline = NanoFlagsOptions.builder()
    .bootstrapJson(Files.readString(Path.of("flags-bootstrap.json")))
    .build();
  • يكتب FileStore ذرّيًا، بصلاحيات للمالك وحده حيث تتوفر صلاحيات POSIX. ويُتحقَّق من النسخة المستعادة مجددًا قبل استخدامها. ونفّذ الواجهة Store لحفظها في مكان آخر.
  • تأخذ bootstrap(Bundle) وbootstrapJson(String) إعدادًا تشحنه مع تطبيقك؛ والإعداد غير الصالح يُتجاهل ويُبلَّغ عنه بالرمز INVALID_BUNDLE.
  • يحمل المخزن قواعد الأعلام، ولا يحمل مفتاح الـ SDK أبدًا.

التحقق من التوقيع

تُفحص كل حزمة (‏Ed25519، حسب معرّف المفتاح) قبل أن تحلّ محل الحزمة المستخدمة: عبر الاستطلاع والمقبس الحي والنسخة المخزّنة على حد سواء. ومع العنوان الأساسي الافتراضي يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الحزمة (NanoFlagsOptions.OFFICIAL_SIGNING_KEYS)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة كما قُدّمت تمامًا.

java
import io.nanoflags.server.Jwk;
import io.nanoflags.server.VerifyOptions;

// Self-hosted or proxied edge: pin your keys and require signatures
NanoFlagsOptions options = NanoFlagsOptions.builder()
    .baseUrl("https://flags.internal.example")
    .verify(VerifyOptions.builder()
        .publicKey(Jwk.ed25519("…base64url public key…", "k1"))
        .require(true)
        .build())
    .build();
  • الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويتلقى onError الرمز SIGNATURE.
  • الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تجعل العميل يحمّل GET /v1/keys مرة واحدة، وعلى الأكثر مرة في الدقيقة. ويحمّل fetchKeys(true) المفاتيح من الحافة بدل تثبيتها؛ والمفاتيح المثبّتة أقوى.
  • تُربط الحزم بأول بيئة وُقّعت لها. ومع عنوان أساسي آخر يكون التحقق معطّلًا ما لم تمرّر verify(…)؛ ويعطّله withoutVerification() صراحةً.
  • تُرفض الحزمة المكتوبة لمحرك تقييم أحدث من NanoFlagsClient.SUPPORTED_ENGINE_VERSION (بالرمز ENGINE) ويبقى الإعداد الحالي: حدّث الحزمة. والسلسلة المعيارية موصوفة في التواقيع.

القياس والإخفاء

تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يحمل الحدث إلا أسماء الخصائص التي تستخدمها قواعد العلم مع أنواع قيمها ({"plan": "string"}).

java
import io.nanoflags.server.NanoFlagsOptions.EventsOptions;

NanoFlagsOptions options = NanoFlagsOptions.builder()
    .events(EventsOptions.builder()
        .sampleRate(0.05)
        .redact(ctx -> Map.of("plan", ctx.getOrDefault("plan", "unknown")))   // what leaves the process
        .build())
    .build();

NanoFlagsOptions quiet = NanoFlagsOptions.builder().events(EventsOptions.disabled()).build();   // no telemetry at all

تتلقى redact نسخة من سياق التقييم وتعيد الخريطة التي تُرسل بدل الافتراضي. ويعطّل EventsOptions.disabled() القياس كله، بما فيه بلاغ الخدمة. ويرسل flush() الأحداث المنتظرة فورًا.

جلسات الاختبار

تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بسياق الجلسة وقد غطّاه سياق الاستدعاء (والغلبة للاستدعاء)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.

java
SessionEvaluator s = flags.session(request.getHeader(NanoFlagsClient.SESSION_HEADER));   // or session(token, "checkout-api")
s.boolVariation("checkout-v2", Map.of("key", userId), false); // session bundle while active
s.isActive(); s.id(); s.expiresAt(); s.revision();

لكل طلب، دون تمرير المقيّم من دالة إلى أخرى: يحتفظ TestSessions بالجلسة الحالية لكل خيط. ولا تعتمد الحزمة على servlet؛ ويكفي مرشّح من بضعة أسطر:

NanoFlagsSessionFilter.java
public final class NanoFlagsSessionFilter implements Filter {        // jakarta.servlet or javax.servlet
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {
        try (TestSessions.Scope scope = TestSessions.open(((HttpServletRequest) req).getHeader(TestSessions.HEADER))) {
            TestSessions.flagsFor(flags);                             // resolve once, before the handler runs
            chain.doFilter(req, res);
        }
    }
}

// anywhere in the request
boolean v2 = TestSessions.flagsFor(flags).boolVariation("checkout-v2", Map.of("key", userId), false);
HttpRequest call = TestSessions.propagate(HttpRequest.newBuilder(pricingUri)).GET().build(); // the next service joins
executor.submit(TestSessions.wrap(task));                            // hand the session to another thread
TestSessions.withSession(job.sessionToken(), () -> process(job));    // queues, jobs and tests
الواجهةالوصف
client.session(token[, service]) · sessionAsync(...)تحلّ الجلسة (GET /v1/session) وتعيد SessionEvaluator؛ ويُرسل service كـ X-NanoFlags-Service (افتراضيًا: service الخاصة بالعميل).
SessionEvaluatorدوال القراءة الخاصة بالعميل، ومعها isActive() وid() وexpiresAt() وrevision().
TestSessions.open(token) · withSession(token, fn)تجعل token الجلسة الحالية لهذا الخيط (وScope من نوع AutoCloseable ويستعيد الجلسة السابقة)؛ والرمز الغائب أو المشوّه يعمل خارج أي جلسة.
TestSessions.flagsFor(client[, service])مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل نطاق وعميل؛ وخارج الجلسة يتصرّف كالعميل.
currentSession() · sessionHeaders() · propagate(builder)الرمز الحالي (أو null)؛ و{x-nanoflags-session: token} (أو فارغ)؛ وتضيف الترويسة إلى طلب java.net.http.
TestSessions.wrap(Runnable / Callable)تشغّل العمل على خيط آخر داخل الجلسة الحالية.
NanoFlagsClient.SESSION_HEADER · isSessionToken(s)"x-nanoflags-session"؛ والرمز من 1 إلى 512 محرفًا ASCII قابلًا للطباعة.
  • تُسأل الحافة مرة واحدة لكل رمز وخدمة، ويتشارك المستدعون المتزامنون الطلب نفسه، ويُخزَّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة (المبلَّغ عنها برمز الخطأ SESSION) 3 ثوانٍ.
  • لا ترمي استثناءً أبدًا: الرمز الغائب أو المشوّه أو المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي، ويتصرّف المقيّم تمامًا كالعميل. وإن انتهت الجلسة أثناء الطلب تصبح غير نشطة وتستمر التقييمات على الإعداد المنشور. ولا تغيّر نسخةٌ منشورة حديثًا جلسةً نشطة.
  • تُمرَّر الجلسة المجهولة إلى الخدمات التالية مع ذلك: الخدمة التالية تقرّر بنفسها.
  • تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط؛ فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى وقت انتهائها.

مزوّد OpenFeature

build.gradle.kts
dependencies { implementation("io.nanoflags:nanoflags-java-openfeature:0.2.0") }
java
import dev.openfeature.sdk.*;
import io.nanoflags.server.NanoFlagsClient;
import io.nanoflags.server.openfeature.NanoFlagsProvider;

NanoFlagsClient flags = NanoFlagsClient.create(System.getenv("NANOFLAGS_SDK_KEY"));
OpenFeatureAPI api = OpenFeatureAPI.getInstance();
api.setProviderAndWait(NanoFlagsProvider.builder(flags).closeClient(true).build());

Client client = api.getClient();
boolean on = client.getBooleanValue("new-checkout", false,
    new ImmutableContext("user-42", Map.of("plan", new Value("pro"))));
  • للـ SDK الرسمي في جافا (dev.openfeature:sdk 1.x). ويبقى التقييم محليًا: يغلّف المزوّد العميل أعلاه، فتعمل التحديثات الحيّة والتواقيع وآخر إعداد سليم بالطريقة نفسها.
  • يصبح مفتاح الاستهداف هو key في NanoFlags (ويتقدّم على خاصية اسمها key). الأسباب: DISABLED وDEFAULT وTARGETING_MATCH وSPLIT (الطرح بالنسب المئوية). والأخطاء: FLAG_NOT_FOUND وPROVIDER_NOT_READY وTYPE_MISMATCH وGENERAL. والمتغيّر (variant) هو معرّف القاعدة؛ وتحمل بيانات العلم الوصفية revision وruleIndex.
  • يطلق المزوّد الأحداث PROVIDER_READY وPROVIDER_STALE وPROVIDER_ERROR وPROVIDER_CONFIGURATION_CHANGED مع مفاتيح الأعلام التي تغيّرت.
  • خيارات المُنشئ: closeClient(true) يغلق عميل NanoFlags حين يوقف OpenFeature المزوّد؛ وinitTimeout(Duration) يحدّ مدة التهيئة (10 ثوانٍ افتراضيًا).

الخيارات

الخيارالافتراضيالوصف
baseUrl(url)https://edge.nanoflags.ioعنوان الحافة.
service(name)"unknown"الاسم الذي تُبلّغ به هذه العملية.
httpClient(HttpClient)ينشئه الـ SDKيستخدم ProxySelector.getDefault() (ويحترم https.proxyHost).
pollInterval(d) · livePollInterval(d)30 ث · 5 دDuration.ZERO يعطّل الاستطلاع.
live(bool) · streaming(bool)trueلتعطيل WebSocket أو أحداث الخادم.
store(Store) · bootstrap(Bundle) · bootstrapJson(String)لا شيءانظر آخر إعداد سليم.
verify(VerifyOptions) · withoutVerification()مفعّل للحافة المستضافةانظر التحقق من التوقيع.
events(EventsOptions)عيّنة 10 %انظر القياس.
requestTimeout(d) · liveConnectTimeout(d)10 ث · 10 ثمهلتا طلب HTTP والاتصال عبر WebSocket.
logger(System.Logger)io.nanoflags.serverمستوى debug فقط.

رموز الأخطاء

تصل أعطال الخلفية إلى onError كـ NanoFlagsException له code() (وhttpStatus() عند الحاجة): NETWORK وUNAUTHORIZED وHTTP وINVALID_BUNDLE وSTORE وCONFIG وSIGNATURE وSESSION وENGINE وENVIRONMENT_DELETED. ولا تغيّر هذه الأعطال الإعداد المستخدم، ولا يُرمى أي شيء من استدعاء قراءة. والمعاني مطابقة لـ SDK جافاسكريبت.

الإغلاق والإيقاف

java
Runtime.getRuntime().addShutdownHook(new Thread(flags::close));

// or scope it
try (NanoFlagsClient job = NanoFlagsClient.create(sdkKey, NanoFlagsOptions.builder().service("nightly-job").build())) {
    run(job);
}
  • يرسل close() القياس المنتظر (بأفضل جهد)، ويوقف كل خيوط الخلفية وينتظرها. واستدعاؤه أكثر من مرة آمن.
  • بعد close() تواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيد refresh() التحقق فورًا، ويرمي NanoFlagsException إن فشل ذلك الطلب.
  • خيوط الخلفية خيوط daemon، فلا تُبقي آلة JVM حيّة.

حل المشكلات

  1. كل قراءة تعيد القيمة الاحتياطية. افحص status() وlastError(). يعني UNAUTHORIZED أن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل.
  2. خلف وسيط. يتبع عميل HTTP الافتراضي ProxySelector.getDefault()، فاضبط https.proxyHost وhttps.proxyPort، أو مرّر HttpClient خاصًا بك. وإن حُجبت ترقية WebSocket يعرض transport() القيمة STREAM أو POLL.
  3. أخطاء بالرمز SIGNATURE. لم تجتز الحزمة التحقق فلم تُستخدم. ومع baseUrl مخصّص ثبّت مفاتيح تلك الحافة عبر VerifyOptions.
  4. أخطاء بالرمز ENVIRONMENT_DELETED. أغلقت الحافة المقبس بالرمز 4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالة STALE؛ استبدل المفتاح.
  5. لمعرفة ما يفعله العميل. مرّر System.Logger عبر logger(…)، أو فعّل سجلات debug لـ io.nanoflags.server.
لغات أخرى
تتوفر حزم SDK أصلية للخوادم أيضًا لـ Python وGo و.NET وPHP وRuby. ويمكن للغات الأخرى قراءة أعلام NanoFlags عبر مزوّد OpenFeature OFREP.