فایل پروژه B4A را چگونه باز کنیم؟
وقتی از پنل ناشر پروژه آماده می‌گیرید، انتظار دارید شناسه رسانه و جایگاه از قبل در کد باشد. بااین‌حال فایل نمونه کد و فایل پروژه یک چیز نیستند. در B4A، فایل دارای پسوند .b4a علاوه بر کد فعالیت اصلی، اطلاعات پروژه، ماژول‌ها، کتابخانه‌ها، پیکربندی ساخت و Manifest را نگه می‌دارد. فایل .bas معمولاً ماژول یا نمونه‌ای برای استفاده در پروژه موجود است. انتخاب فایل اشتباه می‌تواند شما را پیش از رسیدن به مرحله اتصال متوقف کند.
در بسته آماده دیدنکس، نقطه شروع Didnex.b4a است. اگر می‌خواهید فقط اتصال تبلیغ را به اپ خود اضافه کنید، نمونه Main و کلاس‌های SDK را با توجه به راهنمای همان پلتفرم در پروژه موجود به کار ببرید. برای این مسیر لازم نیست پروژه اصلی اپ را با پروژه نمونه جایگزین کنید.
استخراج کامل بسته، پیش از بازکردن
ابتدا فایل ZIP را در یک پوشه مستقل استخراج کنید. بازکردن یک فایل از داخل پنجره فشرده‌ساز ممکن است فقط همان فایل را به پوشه موقت منتقل کند. در این حالت پروژه به کلاس‌های کنار خود دسترسی ندارد و خطای نبود ماژول می‌دهد. فایل اصلی پروژه و کلاس‌های Didnex، DidnexAds و DidnexPush باید در ساختار بسته باقی بمانند.
نسخه جدید را روی پوشه‌ای پر از فایل قدیمی کپی نکنید. یک پوشه تازه بسازید تا معلوم باشد کدام فایل‌ها متعلق به همین دانلود هستند. اطلاعات نسخه و فهرست هش فایل‌ها در PROJECT_INFO.json برای مقایسه بسته وجود دارد. این فهرست سلامت محتوا را نشان می‌دهد؛ جایگزین اجرای کامپایلر و آزمون روی دستگاه نیست.
مسیر ابزارها و کتابخانه‌ها
بعد از بازشدن پروژه، مسیر JDK و Android SDK نصب‌شده را در تنظیمات ابزار B4A بررسی کنید. پروژه آماده، ابزارهای توسعه را روی رایانه شما نصب نمی‌کند. کتابخانه‌های اعلام‌شده در README نیز باید در محیط شما موجود باشند. برای نمونه تبلیغ، مجوز اینترنت لازم است؛ مجوز مکان یا اعلان را صرفاً برای رفع خطای تبلیغ اضافه نکنید.
نام بسته را با خروجی واقعی مقایسه کنید
نام بسته پیکربندی ساخت باید با اپ تأییدشده در پنل ناشر یکسان باشد. برچسب نمایشی اپ، نام فایل پروژه و نام بسته سه مقدار متفاوت‌اند. اگر چند پیکربندی ساخت دارید، مقدار پیکربندی فعال را بررسی کنید. راهنمای شناسه جایگاه تبلیغ و پوش کمک می‌کند شناسه اپ را با شناسه جایگاه اشتباه نگیرید.
مشکل بازشدن، کامپایل و اتصال را جدا کنید
اگر IDE اصلاً پروژه را باز نمی‌کند، ابتدا فایل اصلی، استخراج کامل و سازگاری محیط را بررسی کنید. اگر پروژه باز می‌شود اما کامپایل شکست می‌خورد، نخستین خطای کامپایلر و نام ماژول درگیر را ثبت کنید. تغییر کشور کمپین یا شارژ حساب در این مرحله خطای کامپایل را حل نمی‌کند.
وقتی اپ اجرا شد، نوبت آزمون اتصال است. از عیب‌یاب همان جایگاه جلسه تست بسازید و پروژه متصل به همان جلسه را دانلود کنید. این تست موقت است و برای آن نیازی به ساخت کمپین پولی نیست. پس از موفقیت، کد یا پروژه انتشار را جایگزین کنید؛ توکن تست نباید مبنای انتشار اپ باشد.
چه گزارشی برای پیگیری بفرستیم؟
نسخه B4A، نسخه Java، نسخه Android SDK، مرحله توقف، نام فایل بازشده و اولین خطای کامل را ثبت کنید. برای خطای اجرا نیز کد خطای SDK و شناسه جلسه کافی است؛ رمز حساب، کلید سرور و توکن‌های ورود را در گزارش قرار ندهید. این اطلاعات مشخص می‌کند مشکل در بسته پروژه است یا ابزار ساخت یا مسیر ارتباط دستگاه.
برای اجرای نمونه، مستندات Basic4Android را کنار README بسته باز کنید. توضیح ساختار پروژه و ماژول‌ها را می‌توانید در راهنمای رسمی شروع B4X نیز دنبال کنید. هدف این مسیر، رسیدن از فایل دانلودشده به یک آزمون قابل تکرار است؛ هر مرحله باید نتیجه مشخص خود را داشته باشد.
