‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

مدیریت الگوهای کارخواه «پیکربندی از راه دور» و نسخه‌گذاری

نوع الگو را انتخاب کنید:

الگوهای کارخواه الگوهای سرور

Remote Config الگوها مجموعه‌ای از پارامترها و شرایط با قالب JSON هستند که برای پروژه Firebase شما ایجاد شده‌اند. الگوهای کارخواه پیکربندی‌ها را به نمونه‌های برنامه‌ای ارائه می‌دهند که کیت‌های توسعه نرم‌افزار کارخواه Firebase را برای Remote Config پیاده‌سازی می‌کنند، ازجمله برنامه‌های Apple،‏ Android،‏ Web،‏ Flutter،‏ Unity، و C++.

می‌توانید از کنسول Firebase برای اصلاح و مدیریت الگوی کارخواهتان استفاده کنید. به DevOps و تعامل > پیکربندی از راه دور بروید تا محتوای الگو را در قالب گرافیکی در صفحه پارامترها و صفحه شرایط مشاهده کنید.

همچنین می‌توانید از Remote Config REST API و Admin SDK یا Firebase CLI برای اصلاح و مدیریت الگوی کارخواه خود استفاده کنید.

در اینجا نمونه‌ای از فایل الگوی کارخواه آورده شده است:

{
  "conditions": [
    {
      "name": "ios",
      "expression": "device.os == 'ios'"
    }
  ],
  "parameters": {
    "welcome_message": {
      "defaultValue": {
        "value": "Welcome to this sample app"
      },
      "conditionalValues": {
        "ios": {
          "value": "Welcome to this sample iOS app"
        }
      }
    },
    "welcome_message_caps": {
      "defaultValue": {
        "value": "false"
      }
    },
    "header_text": {
      "defaultValue": {
        "useInAppDefault": true
      }
    }
  },
  "version": {
    "versionNumber": "28",
    "updateTime": "2020-05-14T18:39:38.994Z",
    "updateUser": {
      "email": "user@google.com"
    },
    "updateOrigin": "CONSOLE",
    "updateType": "INCREMENTAL_UPDATE"
  }
}

می‌توانید این تکالیف مدیریت نسخه را در کنسول Firebase انجام دهید (به DevOps و تعامل > پیکربندی از راه دور بروید):

فهرست کردن همه نسخه‌های ذخیره‌شده الگو
بازیابی نسخه‌ای خاص
برگشتن به نسخه مشتری خاص
Remote Config الگو را از صفحه «سابقه تغییرات» حذف کنید.

همچنین می‌توانید بااستفاده از میاناهای برنامه‌سازی کاربردی Firebase CLI و Remote Config backend، الگوها را فهرست کنید، الگوها را بازیابی کنید، و الگوها را برگردانید.

درمجموع محدودیت ۳۰۰ نسخه ذخیره‌شده مادام‌العمر برای هر نوع الگو وجود دارد (۳۰۰ الگوی کارخواه و ۳۰۰ الگوی سرور)، که شامل شماره نسخه‌های ذخیره‌شده برای الگوهای حذف‌شده می‌شود. اگر در طول عمر پروژه بیش‌از ۳۰۰ نسخه الگو برای هر نوع الگو منتشر کنید، نسخه‌های اولیه حذف می‌شوند و حداکثر ۳۰۰ نسخه از آن نوع حفظ می‌شود.

هربار که پارامترها را به‌روز می‌کنید، Remote Config الگوی Remote Config نسخه‌دار جدیدی ایجاد می‌کند و الگوی قبلی را به‌عنوان نسخه‌ای ذخیره می‌کند که می‌توانید درصورت نیاز آن را بازیابی کنید یا به آن برگردید. شماره‌های نسخه به‌صورت متوالی از مقدار اولیه ذخیره‌شده توسط Remote Config افزایش می‌یابند. همه الگوها شامل یک فیلد version هستند که فراداده مربوط به آن نسخه خاص را دربرمی‌گیرد.

درصورت نیاز می‌توانید الگوهای Remote Config را در صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر در کنسول Firebase حذف کنید.

مدیریت کردن نسخه‌های الگوی Remote Config

این بخش نحوه مدیریت نسخه‌های الگوی Remote Config را شرح می‌دهد.

برای جزئیات بیشتر درباره نحوه ایجاد، اصلاح، و ذخیره الگوها به‌صورت برنامه‌نویسی‌شده، به اصلاح Remote Config به‌صورت برنامه‌نویسی‌شده مراجعه کنید.

فهرست کردن همه نسخه‌های ذخیره‌شده الگوی Remote Config

می‌توانید فهرستی از همه نسخه‌های ذخیره‌شده الگوی Remote Config را بازیابی کنید. برای این کار:

کنسول Firebase

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.
نماد «ساعت» را که در بالا سمت چپ نمایش داده می‌شود انتخاب کنید.

با این کار، صفحه سابقه تغییرات باز می‌شود که همه نسخه‌های ذخیره‌شده الگو را در منو فهرستی در سمت چپ فهرست می‌کند.

جزئیات نمایش‌داده‌شده برای هر نسخه ذخیره‌شده شامل اطلاعاتی درباره این است که آیا تغییرات از کنسول Firebase، با REST API، از بازگشت به نسخه قبلی، یا تغییرات افزایشی از ذخیره اجباری الگو منشأ گرفته‌اند یا نه.

Firebase CLI

firebase remoteconfig:versions:list

از گزینه --limit برای محدود کردن تعداد نسخه‌هایی که برگردانده می‌شوند استفاده کنید. برای واکشی همه نسخه‌ها، «۰» را ارسال کنید.

Node.js

function listAllVersions() {
admin.remoteConfig().listVersions()
.then((listVersionsResult) => {
  console.log("Successfully fetched the list of versions");
  listVersionsResult.versions.forEach((version) => {
    console.log('version', JSON.stringify(version));
  });
})
.catch((error) => {
  console.log(error);
});
}

جاوا

ListVersionsPage page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
while (page != null) {
  for (Version version : page.getValues()) {
    System.out.println("Version: " + version.getVersionNumber());
  }
  page = page.getNextPage();
}

// Iterate through all versions. This will still retrieve versions in batches.
page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
for (Version version : page.iterateAll()) {
  System.out.println("Version: " + version.getVersionNumber());
}

REST (انتقال بازنمودی وضعیت)

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:listVersions

فهرست الگوها شامل فراداده برای همه نسخه‌های ذخیره‌شده است، ازجمله زمان به‌روزرسانی، کاربری که آن را انجام داده است، و نحوه انجام آن. در اینجا مثالی از عنصر نسخه آورده شده است:

{
  "versions": [{
    "version_number": "6",
    "update_time": "2022-05-12T02:38:54Z",
    "update_user": {
      "name": "Jane Smith",
      "email": "jane@developer.org",
      "imageUrl": "https://lh3.googleusercontent.com/a-/..."
    },
    "description": "One small change on the console",
    "origin": "CONSOLE",
    "update_type": "INCREMENTAL_UPDATE"
  }]
}

بازیابی نسخه خاصی از الگوی Remote Config

می‌توانید هر نسخه ذخیره‌شده خاصی از الگوی Remote Config را بازیابی کنید. در اینجا نحوه بازیابی نسخه الگوی ذخیره‌شده آمده است:

کنسول Firebase

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر بروید.
به‌طور پیش‌فرض، صفحه الگوی فعال فعلی را نمایش می‌دهد. برای مشاهده نسخه‌ای دیگر، آن را از بخش جزئیات در سمت چپ انتخاب کنید.
با نگه داشتن نشانگر روی منوِ بافت برای هر نسخه انتخاب‌نشده و انتخاب مقایسه با نسخه انتخاب‌شده، تفاوت‌های دقیق الگوی فعال و هر نسخه ذخیره‌شده دیگر را مشاهده کنید.

Firebase CLI

firebase remoteconfig:get -v VERSION_NUMBER

درصورت تمایل، می‌توانید خروجی را با -o, FILENAME در فایل مشخصی بنویسید.

Node.js

getTemplate را بدون هیچ آرگومانی ارسال کنید تا جدیدترین نسخه الگو را بازیابی کنید، یا برای بازیابی نسخه‌ای خاص، از getTemplateAtVersion استفاده کنید.

// Get template version: 6
admin.remoteConfig().getTemplateAtVersion('6')
.then((template) => {
console.log("Successfully fetched the template with ETag: " + template.etag);
})
.catch((error) => {
console.log(error);
});

جاوا

Template template = FirebaseRemoteConfig.getInstance().getTemplateAtVersionAsync(versionNumber).get();
// See the ETag of the fetched template.
System.out.println("Successfully fetched the template with ETag: " + template.getETag());

REST (انتقال بازنمودی وضعیت)

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?version_number=6

پارامتر نشانی وب ?version_number فقط برای عملیات GET معتبر است؛ نمی‌توانید از آن برای مشخص کردن شماره نسخه برای به‌روزرسانی‌ها استفاده کنید. درخواست get مشابهی بدون پارامتر ?version_number، الگوی فعال فعلی را بازیابی می‌کند.

برگشتن به نسخه ذخیره‌شده خاصی از الگوی Remote Config

می‌توانید به هر نسخه ذخیره‌شده‌ای از الگو عقب‌گرد کنید. نحوه عقب‌گرد کردن الگو در اینجا آمده است:

کنسول Firebase

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > سابقه تغییر بروید.
دکمه گزینه را در بالا سمت چپ صفحه برای نسخه‌های قبلی الگو که واجدشرایط بازگشت هستند پیدا کنید.
فقط درصورتی روی این گزینه کلیک و آن را تأیید کنید که مطمئن باشید می‌خواهید به آن نسخه برگردید و از آن مقادیر بلافاصله برای همه برنامه‌ها و کاربران استفاده کنید.

Firebase CLI

firebase remoteconfig:rollback -v VERSION_NUMBER

Node.js

// Roll back to template version: 6
admin.remoteConfig().rollback('6')
  .then((template) => {
    console.log("Successfully rolled back to template version 6.");
    console.log("New ETag: " + template.etag);
  })
  .catch((error) => {
    console.log('Error trying to rollback:', e);
  })

جاوا

try {
  Template template = FirebaseRemoteConfig.getInstance().rollbackAsync(versionNumber).get();
  System.out.println("Successfully rolled back to template version: " + versionNumber);
  System.out.println("New ETag: " + template.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Error trying to rollback template.");
    System.out.println(rcError.getMessage());
  }
}

REST (انتقال بازنمودی وضعیت)

برای بازگشت به الگوی ذخیره‌شده Remote Config، یک HTTP POST با روش سفارشی :rollback و در بدنه درخواست، نسخه خاصی را برای اعمال صادر کنید. برای مثال:

curl --compressed -D headers -H "Authorization: Bearer token" -H "Content-Type: application/json" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:rollback -d '{"version_number": 6}'

پاسخ حاوی محتوای الگوی ذخیره‌شده‌ای است که اکنون فعال است، به‌همراه فراداده نسخه جدید آن.

توجه داشته باشید که این عملیات بازگرداندن درواقع نسخه شماره‌دار جدیدی ایجاد می‌کند. برای مثال، بازگرداندن از نسخه ۱۰ به نسخه ۶ به‌طور مؤثری کپی جدیدی از نسخه ۶ ایجاد می‌کند که تنها تفاوت آن با نسخه اصلی این است که شماره نسخه آن ۱۱ است. نسخه اصلی ۶ هنوز ذخیره است، با فرض اینکه به تاریخ انقضایش نرسیده باشد، و نسخه ۱۱ به الگوی فعال تبدیل می‌شود.

حذف کردن الگوی Remote Config

می‌توانید الگوهای Remote Config را بااستفاده از کنسول Firebase حذف کنید. نحوه حذف الگو در اینجا آمده است:

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.
روی سابقه تغییر کلیک کنید.
به الگویی که می‌خواهید حذف کنید بروید، روی بیشتر کلیک کنید، سپس حذف را انتخاب کنید.
وقتی از شما خواسته شد حذف را تأیید کنید، روی حذف کلیک کنید.

بارگیری و انتشار الگوهای Remote Config

الگوهای Remote Config را بارگیری و منتشر کنید تا آن‌ها را در سیستم‌های ساخت و کنترل منبع خود ادغام کنید، به‌روزرسانی‌های پیکربندی را خودکار کنید، و پارامترها و مقادیر را در چندین پروژه همگام‌سازی کنید.

می‌توانید الگوی Remote Config فعال کنونی را به‌صورت برنامه‌نویسی‌شده یا از کنسول Firebase بارگیری کنید. سپس می‌توانید فایل JSON صادرشده را به‌روز کنید و آن را در همان پروژه منتشر کنید، یا آن را در پروژه جدید یا موجودی منتشر کنید.

برای مثال، فرض کنید چند پروژه دارید که مراحل مختلف چرخه حیات توسعه نرم‌افزارتان را نشان می‌دهند، مثل محیط‌های توسعه، آزمایش، آماده‌سازی، و تولید. در این حالت، می‌توانید الگوی کاملاً آزمایش‌شده‌ای را از محیط آماده‌سازی به محیط تولید ارتقا دهید. برای این کار، الگو را از پروژه آماده‌سازی بارگیری کنید و آن را در پروژه تولید منتشر کنید.

همچنین می‌توانید از این روش برای انتقال پیکربندی‌ها از یک پروژه به پروژه دیگر یا پر کردن پروژه جدید با پارامترها و مقادیر یک پروژه ایجادشده استفاده کنید.

پارامترها و مقادیر پارامتر که به‌طور خاص به‌عنوان متغیر در آزمایش A/B Testing ایجاد شده‌اند در الگوهای صادرشده گنجانده نمی‌شوند.

برای صادر کردن و وارد کردن الگوهای Remote Config:

الگوی Remote Config فعلی را بارگیری کنید.
الگوی Remote Config را اعتبارسنجی کنید.
الگوی Remote Config را منتشر کنید.

بارگیری الگوی Remote Config فعلی

از موارد زیر برای بارگیری الگوی فعال Remote Config در قالب JSON استفاده کنید:

کنسول Firebase

در کنسول Firebase، به صفحه DevOps & Engagement (توسعه و تعامل) > Remote Config (پیکربندی از راه دور) > Parameters or Conditions (پارامترها یا شرایط) بروید.
منو را باز کنید و بارگیری فایل پیکربندی فعلی را انتخاب کنید.
وقتی درخواست شد، روی بارگیری فایل پیکربندی کلیک کنید، مکانی را که می‌خواهید فایل در آن ذخیره شود انتخاب کنید، سپس روی ذخیره کلیک کنید.

Firebase CLI

firebase remoteconfig:get -o filename

Node.js

function getTemplate() {
  var config = admin.remoteConfig();
  config.getTemplate()
      .then(function (template) {
        console.log('ETag from server: ' + template.etag);
        var templateStr = JSON.stringify(template);
        fs.writeFileSync('config.json', templateStr);
      })
      .catch(function (err) {
        console.error('Unable to get template');
        console.error(err);
      });
}

جاوا

Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get();
// See the ETag of the fetched template.
System.out.println("ETag from server: " + template.getETag());

REST (انتقال بازنمودی وضعیت)

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename

این فرمان پایه‌بار JSON را در یک فایل و سرصفحه‌ها (ازجمله ETag) را در فایل headers جداگانه‌ای برونداد می‌کند.

اعتبارسنجی الگوی Remote Config

می‌توانید به‌روزرسانی‌های الگو را قبل‌از انتشار بااستفاده از Firebase Admin SDK یا REST API اعتبارسنجی کنید. وقتی می‌خواهید ازطریق CLI Firebase یا کنسول Firebase منتشر کنید، الگوها نیز اعتبارسنجی می‌شوند.

فرایند اعتبارسنجی الگو خطاهایی مانند کلیدهای تکراری برای پارامترها و شرایط، نام‌های شرط نامعتبر یا شرایط غیرموجود، یا ETags با قالب‌بندی نادرست را بررسی می‌کند. برای مثال، درخواستی که حاوی بیش‌از تعداد مجاز کلیدها (۲۰۰۰) باشد، پیام خطای Param count too large را برمی‌گرداند.

Node.js

function validateTemplate(template) {
  admin.remoteConfig().validateTemplate(template)
      .then(function (validatedTemplate) {
        // The template is valid and safe to use.
        console.log('Template was valid and safe to use');
      })
      .catch(function (err) {
        console.error('Template is invalid and cannot be published');
        console.error(err);
      });
}

جاوا

try {
  Template validatedTemplate = FirebaseRemoteConfig.getInstance()
          .validateTemplateAsync(template).get();
  System.out.println("Template was valid and safe to use");
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Template is invalid and cannot be published");
    System.out.println(rcError.getMessage());
  }
}

REST (انتقال بازنمودی وضعیت)

به‌روزرسانی‌های الگو را با افزودن پارامتر نشانی وب ?validate_only=true به درخواست انتشار خود اعتبارسنجی کنید:

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?validate_only=true -d @filename

اگر الگوی شما با موفقیت اعتبارسنجی شده باشد، فرمان curl الگوی JSON را که ارسال کرده‌اید برمی‌گرداند و در فایل headers ذخیره‌شده، وضعیت HTTP/2 200 و ETag به‌روزشده با پسوند -0 را خواهید دید. اگر الگوی شما اعتبارسنجی نشده باشد، خطای اعتبارسنجی را در پاسخ JSON دریافت خواهید کرد و فایل headers شما حاوی پاسخ غیر ۲۰۰ (و بدون ETag) خواهد بود.

انتشار الگو Remote Config

پس‌از بارگیری الگو، اعمال تغییرات لازم در محتوای JSON، و اعتبارسنجی آن، می‌توانید آن را در پروژه‌ای منتشر کنید.

با انتشار الگو، کل الگوی پیکربندی موجود با فایل به‌روزشده جایگزین می‌شود و نسخه الگو یک عدد افزایش می‌یابد. چون کل پیکربندی جایگزین می‌شود، اگر پارامتری را از فایل JSON حذف کنید و آن را منتشر کنید، پارامتر از سرور حذف می‌شود و دیگر برای مشتریان دردسترس نخواهد بود.

پس‌از انتشار، تغییرات پارامترها و مقادیر بلافاصله برای برنامه‌ها و کاربران شما دردسترس قرار می‌گیرند. درصورت لزوم، می‌توانید به نسخه قبلی برگردید.

از فرمان‌های زیر برای انتشار الگوی خود استفاده کنید:

کنسول Firebase

در کنسول Firebase، به صفحه DevOps & Engagement (توسعه و تعامل) > Remote Config (پیکربندی از راه دور) > Parameters or Conditions (پارامترها یا شرایط) بروید.
منو را باز کنید، و انتشار از فایل را انتخاب کنید.
وقتی از شما خواسته شد، روی مرور کلیک کنید، به فایل Remote Config که می‌خواهید منتشر کنید بروید و آن را انتخاب کنید، سپس روی انتخاب کلیک کنید.
Firebase فایل را اعتبارسنجی می‌کند. اگر اعتبارسنجی موفقیت‌آمیز بود، روی انتشار کلیک کنید تا پیکربندی فوراً برای برنامه‌ها و کاربران دردسترس قرار گیرد.

Node.js

function publishTemplate() {
  var config = admin.remoteConfig();
  var template = config.createTemplateFromJSON(
      fs.readFileSync('config.json', 'UTF8'));
  config.publishTemplate(template)
      .then(function (updatedTemplate) {
        console.log('Template has been published');
        console.log('ETag from server: ' + updatedTemplate.etag);
      })
      .catch(function (err) {
        console.error('Unable to publish template.');
        console.error(err);
      });
}

جاوا

try {
  Template publishedTemplate = FirebaseRemoteConfig.getInstance()
          .publishTemplateAsync(template).get();
  System.out.println("Template has been published");
  // See the ETag of the published template.
  System.out.println("ETag from server: " + publishedTemplate.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Unable to publish template.");
    System.out.println(rcError.getMessage());
  }
}

REST (انتقال بازنمودی وضعیت)

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename

برای این فرمان curl، می‌توانید محتوا را بااستفاده از نویسه «@» و سپس نام فایل مشخص کنید.

Remote Config شخصی‌سازی و شرط در الگوهای بارگیری‌شده گنجانده شده است، بنابراین هنگام تلاش برای انتشار در پروژه‌ای دیگر، باید از محدودیت‌های زیر آگاه باشید:

شخصی‌سازی‌ها را نمی‌توان از پروژه‌ای به پروژه دیگر وارد کرد.

برای مثال، اگر شخصی‌سازی‌ها را در پروژه‌تان فعال کرده باشید و الگویی را بارگیری و ویرایش کنید، می‌توانید آن را در همان پروژه منتشر کنید، اما نمی‌توانید آن را در پروژه دیگری منتشر کنید مگراینکه شخصی‌سازی‌ها را از الگو حذف کنید.
شرایط را می‌توان از پروژه‌ای به پروژه دیگر وارد کرد، اما توجه داشته باشید که هرگونه مقدار شرطی خاص (مانند شناسه‌های برنامه یا مخاطبان) باید قبل‌از انتشار در پروژه هدف وجود داشته باشد.

برای مثال، اگر پارامتر Remote Config دارید که از شرطی استفاده می‌کند که مقدار پلاتفرم iOS را مشخص می‌کند، الگو می‌تواند در پروژه دیگری منتشر شود، زیرا مقادیر پلاتفرم برای هر پروژه‌ای یکسان است. بااین‌حال، اگر حاوی شرطی باشد که به شناسه برنامه یا مخاطب کاربر خاصی متکی باشد که در پروژه هدف وجود ندارد، اعتبارسنجی ناموفق خواهد بود.
اگر الگویی که قصد انتشار آن را دارید حاوی شرایطی است که به Google Analytics متکی است، Analytics باید در پروژه هدف فعال باشد.

بارگیری پیش‌فرض‌های الگوی Remote Config

چون ممکن است برنامه‌تان همیشه به اینترنت متصل نباشد، باید مقادیر پیش‌فرض برنامه سمت کارخواه را برای همه پارامترهای Remote Config پیکربندی کنید. همچنین باید به‌طور دوره‌ای مقادیر پیش‌فرض کارخواه برنامه و مقادیر پارامتر پیش‌فرض پس‌بخش Remote Config را همگام‌سازی کنید، زیرا ممکن است درطول زمان تغییر کنند.

همان‌طور که در پیوندهای مختص پلاتفرم در انتهای این بخش شرح داده شده است، می‌توانید این پیش‌فرض‌ها را به‌صورت دستی در برنامه‌تان تنظیم کنید یا می‌توانید این فرایند را با بارگیری فایل‌هایی که فقط حاوی جفت‌های کلید-مقدار برای همه پارامترها و مقادیر پیش‌فرض آن‌ها در الگوی فعال Remote Config هستند ساده‌سازی کنید. سپس می‌توانید این فایل را در پروژه‌تان بگنجانید و برنامه‌تان را برای وارد کردن این مقادیر پیکربندی کنید.

می‌توانید این فایل‌ها را در قالب XML برای برنامه‌های Android، قالب فهرست ویژگی (plist) برای برنامه‌های iOS، و JSON برای برنامه‌های وب بارگیری کنید.

پیش‌از هرگونه انتشار برنامه جدید، به‌طور دوره‌ای پیش‌فرض‌های Remote Config را بارگیری کنید تا مطمئن شوید برنامه شما و باطن Remote Config همگام‌سازی شده‌اند.

در اینجا نحوه بارگیری فایلی که حاوی پیش‌فرض‌های الگو است آورده شده است:

REST (انتقال بازنمودی وضعیت)

curl --compressed -D headers -H "Authorization: Bearer token -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=file_format'

بسته به اینکه کدام قالب فایل را می‌خواهید بارگیری کنید، از XML،‏ PLIST، یا JSON به‌عنوان مقدار format استفاده کنید.

کنسول Firebase

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.
منو را باز کنید و بارگیری مقادیر پیش‌فرض را انتخاب کنید.
وقتی از شما خواسته شد، روی دکمه رادیویی مربوط به قالب فایلی که می‌خواهید بارگیری کنید کلیک کنید، سپس روی بارگیری فایل کلیک کنید.

برای اطلاعات بیشتر درباره وارد کردن مقادیر پیش‌فرض Remote Config به برنامه، به این بخش مراجعه کنید:

مدیریت الگوهای کارخواه «پیکربندی از راه دور» و نسخه‌گذاری با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

مدیریت کردن نسخه‌های الگوی Remote Config

فهرست کردن همه نسخه‌های ذخیره‌شده الگوی Remote Config

کنسول Firebase

Firebase CLI

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

بازیابی نسخه خاصی از الگوی Remote Config

کنسول Firebase

Firebase CLI

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

برگشتن به نسخه ذخیره‌شده خاصی از الگوی Remote Config

کنسول Firebase

Firebase CLI

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

حذف کردن الگوی Remote Config

بارگیری و انتشار الگوهای Remote Config

بارگیری الگوی Remote Config فعلی

کنسول Firebase

Firebase CLI

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

اعتبارسنجی الگوی Remote Config

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

انتشار الگو Remote Config

کنسول Firebase

Node.js

جاوا

REST (انتقال بازنمودی وضعیت)

بارگیری پیش‌فرض‌های الگوی Remote Config

REST (انتقال بازنمودی وضعیت)

کنسول Firebase

مدیریت الگوهای کارخواه «پیکربندی از راه دور» و نسخه‌گذاری