باز کردن یک برنامهٔ سفارشی React

هدف

یک برنامهٔ سفارشی React را که در یک محیط ثبت شده است، از صفحهٔ خانهٔ پوستهٔ پلتفرم باز کنید.

پیش‌نیازها

• وارد پوستهٔ پلتفرم شده‌اید.
• به محیطی که برنامهٔ سفارشی React در آن نصب شده است دسترسی دارید.
• برنامهٔ سفارشی React در همان محیط ثبت شده است (به «ثبت یک برنامهٔ سفارشی React» نگاه کنید).

گام‌ها

1. در پوستهٔ پلتفرم، با تعویض‌کنندهٔ محیط محیطی را انتخاب کنید که برنامهٔ سفارشی React در آن نصب شده است.
2. به صفحهٔ خانهٔ پوسته بروید. برنامهٔ سفارشی React در کنار برنامه‌های Model-Driven داخلی، با همان نام نمایشی‌ای که با آن ثبت شده است، ظاهر می‌شود.
3. برنامهٔ سفارشی React را انتخاب کنید. پوسته آن را بارگذاری می‌کند و برنامه در همان‌جا باز می‌شود.

پشت صحنه چه اتفاقی می‌افتد

پوستهٔ پلتفرم پیش از بارگذاری برنامه، یک توکن دسترسی محدود و کوتاه‌عمر درخواست می‌کند که دامنهٔ آن فقط همان برنامه و همان محیط است، سپس کد ریموت برنامه را بارگذاری کرده و مستقیماً رندر می‌کند — برنامه به جای اجرا در یک قاب جداگانه، از همان تک نسخهٔ زمان اجرای React پوسته استفاده می‌کند. برنامه تنها از راه Runtime SDK که پوسته فراهم می‌کند به داده‌ها و ثبت وقایع پلتفرم می‌رسد، بنابراین همیشه با همان مجوزهای کاربرِ واردشده در محیط جاری عمل می‌کند. برنامه‌ای که کد آن از مبدأیی سرو شود که محیط آن را در فهرست مجاز ندارد، پیش از بارگذاری رد می‌شود.

عیب‌یابی

• برنامه در صفحهٔ خانه فهرست نشده است. — مطمئن شوید در همان محیطی هستید که برنامه در آن ثبت شده است؛ برنامهٔ سفارشی React نصب‌شده در یک محیط تا زمانی که راه‌حل آن در محیط دیگری وارد نشود، در آن محیط ظاهر نمی‌شود.
• «This app's code is served from a blocked origin.» — نشانی remoteEntry برنامه در فهرست مجاز محیط نیست. یک مدیر باید پیش از آنکه پوسته برنامه را بارگذاری کند، آن مبدأ را اضافه کند.

سناریوهای مرتبط

• ثبت یک برنامهٔ سفارشی React.