مدیریت کیاستور
Keystore چیست؟
Keystore یا «کلید برنامه»، یک فایل امنیتی برای امضای دیجیتال اپلیکیشنهای اندروید است. هر اپلیکیشن اندروید برای اینکه بتواند نصب، منتشر یا بهروزرسانی شود، باید با یک کلید مشخص امضا شود.
به زبان ساده، Keystore مثل امضای رسمی اپلیکیشن شماست. این امضا مشخص میکند که اپ توسط چه سازندهای ساخته شده و نسخههای بعدی همان اپ نیز توسط همان سازنده منتشر شدهاند.
اگر یک اپلیکیشن را با یک Keystore منتشر کنید، برای بهروزرسانی همان اپ در آینده نیز باید از همان Keystore استفاده کنید. اگر کلید را تغییر دهید، نسخه جدید به عنوان آپدیت اپ قبلی شناسایی نمیشود.
چرا Keystore مهم است؟
Keystore یکی از مهمترین اطلاعات مربوط به اپلیکیشن شماست، چون:
- برای ساخت خروجی اندروید استفاده میشود.
- برای انتشار اپ در مارکتها لازم است.
- برای بهروزرسانی نسخههای بعدی همان اپ ضروری است.
- هویت سازنده یا مالک اپلیکیشن را مشخص میکند.
- در صورت گم شدن فایل یا فراموشی رمزها، ممکن است امکان آپدیت اپ را از دست بدهید.
فایل Keystore و رمزهای آن را حتماً در جای امن نگهداری کنید. اگر فایل کلید یا رمزهای آن را از دست بدهید، ممکن است دیگر نتوانید اپلیکیشن منتشرشده را بهروزرسانی کنید.
مدیریت کلید در اپ ادیتور
در اپ ادیتور، هنگام دریافت خروجی اندروید، بخشی با عنوان مدیریت کلید وجود دارد. در این بخش میتوانید کلیدهای مربوط به اپلیکیشنهای خود را مدیریت کنید.
در بخش مدیریت کلید، امکانات زیر در اختیار شما قرار دارد:
- مشاهده لیست کلیدهای ساختهشده
- ساخت کلید جدید
- استفاده از کلیدهای قبلی برای اپلیکیشنهای مختلف
- آپلود کلید آماده در صورت داشتن فایل و رمزها
- انتخاب کلید مناسب هنگام ساخت خروجی اندروید
این بخش کمک میکند برای هر خروجی اندروید، کلید مناسب را انتخاب کنید و در آینده برای آپدیت اپ دچار مشکل نشوید.
ساخت کلید جدید در اپ ادیتور
اگر هنوز Keystore ندارید، میتوانید از بخش مدیریت کلید در اپ ادیتور یک کلید جدید بسازید.
در فرم ساخت کلید، اطلاعاتی مانند عنوان، نام، سازمان، شهر، استان، کشور و رمزهای مربوط به کلید از شما دریافت میشود. این اطلاعات برای ساخت امضای دیجیتال اپلیکیشن استفاده میشوند.
هنگام تکمیل فرم ساخت کلید، بهتر است نکات زیر را رعایت کنید:
- اطلاعات را کامل و دقیق وارد کنید.
- برای ورود اطلاعات، تا حد امکان از کاراکترهای لاتین استفاده کنید.
- عنوان کلید فقط برای نمایش در پنل است و میتواند فارسی باشد.
- برای کد کشور ایران میتوانید از
IRاستفاده کنید. - رمزهای واردشده را در جای امن ذخیره کنید.
- بعد از ساخت کلید، در نگهداری آن دقت کنید؛ چون برای آپدیتهای بعدی اپ به آن نیاز خواهید داشت.
عنوان کلید فقط برای نمایش در پنل اپ ادیتور استفاده میشود و میتواند فارسی باشد؛ اما بهتر است سایر اطلاعات هویتی مانند نام، شهر، استان و سازمان را با حروف لاتین وارد کنید.
استفاده از کلید آماده یا قبلی
اگر از قبل فایل Keystore و رمزهای مربوط به آن را در اختیار دارید، میتوانید آن را در بخش مدیریت کلید اپ ادیتور آپلود کنید.
برای استفاده از کلید آماده، معمولاً به اطلاعات زیر نیاز دارید:
- فایل Keystore
- رمز Keystore
- نام Alias
- رمز Alias
بعد از آپلود موفق کلید، میتوانید از آن برای ساخت خروجی اندروید اپلیکیشنهای خود استفاده کنید.
این قابلیت مخصوصاً زمانی مفید است که قبلاً اپلیکیشنی را با یک کلید مشخص منتشر کردهاید و اکنون میخواهید نسخه جدید همان اپ را بسازید. در چنین حالتی باید حتماً از همان Keystore قبلی استفاده کنید.
اگر اپ شما قبلاً در بازار، مایکت، گوگلپلی یا هر مارکت دیگری منتشر شده است، برای انتشار نسخه جدید همان اپ باید خروجی جدید را با همان Keystore قبلی بسازید.
نکته مهم درباره آپدیت اپلیکیشن
اگر اپلیکیشنی را قبلاً منتشر کردهاید، برای انتشار نسخه جدید همان اپ باید خروجی جدید با همان کلید قبلی ساخته شود.
قبل از ساخت خروجی، حتماً موارد زیر را بررسی کنید:
- Package Name اپ تغییر نکرده باشد.
- Keystore صحیح انتخاب شده باشد.
- رمز Keystore درست وارد شده باشد.
- Alias درست انتخاب یا وارد شده باشد.
- رمز Alias درست وارد شده باشد.
- همان کلیدی استفاده شود که نسخه قبلی اپ با آن ساخته شده است.
تغییر Keystore باعث میشود نسخه جدید اپ به عنوان آپدیت نسخه قبلی شناسایی نشود. در این حالت کاربران فعلی نمیتوانند اپ را به صورت عادی بهروزرسانی کنند.
آیا میتوان از یک Keystore برای چند اپ استفاده کرد؟
بله. از نظر فنی میتوانید از یک Keystore برای چند اپلیکیشن مختلف استفاده کنید.
حتی اگر یک Keystore توسط گوگل بررسی و از حالت مسدودی خارج شده باشد، میتوانید از همان Keystore برای اپهای دیگر نیز استفاده کنید و معمولاً نیازی به رفع مسدودی مجدد نیست.
برای مدیریت بهتر، بهتر است بدانید هر اپ با کدام Keystore ساخته شده است. این موضوع در زمان آپدیت یا رفع مشکلات احتمالی بسیار مهم است.
جلوگیری از مسدود شدن اپ توسط Google Play Protect
گاهی ممکن است پس از نصب فایل APK، اندروید یا Google Play Protect به کاربر هشدار دهد یا اپلیکیشن را مسدود کند. این موضوع میتواند به دلایل مختلفی رخ دهد؛ از جمله جدید بودن امضای اپ، ناشناس بودن سازنده، رفتارهای حساس برنامه، یا نبود سابقه کافی برای فایل و کلید امضای آن.
برای کاهش احتمال مسدود شدن اپ، هنگام ساخت کلید و خروجی اندروید به نکات زیر توجه کنید:
- اطلاعات فرم ساخت کلید را کامل و دقیق وارد کنید.
- برای اطلاعات هویتی از کاراکترهای لاتین استفاده کنید.
- برای کد کشور ایران از
IRاستفاده کنید. - از یک Keystore معتبر و ثابت برای خروجیهای بعدی استفاده کنید.
- فایل APK را از منابع نامعتبر یا مشکوک منتشر نکنید.
- اگر اپ شما نیاز به مجوزهای حساس دارد، دلیل استفاده از آنها را بررسی کنید.
- از تغییر مداوم Package Name و Keystore خودداری کنید.
مسدود شدن اپ توسط Google Play Protect همیشه به معنی مخرب بودن اپ نیست. گاهی اپهای جدید یا کلیدهای جدید به دلیل نداشتن سابقه کافی، نیاز به بررسی توسط گوگل دارند.
اگر اپ توسط گوگل مسدود شد چه کار کنیم؟
اگر اپ شما توسط Google Play Protect مسدود شد، میتوانید از طریق فرم رسمی گوگل درخواست بررسی و رفع مسدودی ارسال کنید.
لینک فرم درخواست بررسی:
https://support.google.com/googleplay/android-developer/contact/protectappeals
فرم رفع مسدودی Google Play Protect برای کاربران داخل ایران فیلتر است. برای باز کردن این لینک و ارسال درخواست، باید از VPN یا ابزار تغییر IP استفاده کنید.
مراحل ارسال اپ به گوگل برای رفع مسدودی
برای ارسال درخواست رفع مسدودی، مراحل زیر را انجام دهید:
1. از اپ خروجی APK بگیرید
ابتدا در اپ ادیتور از اپلیکیشن خود خروجی اندروید بگیرید. بهتر است خروجی با همان Keystore اصلی اپ ساخته شده باشد.
اگر هدف شما رفع مسدودی یک Keystore است، خروجی باید با همان کلیدی ساخته شود که میخواهید توسط گوگل بررسی و تأیید شود.
APK ارسالی به گوگل باید با همان Keystore امضا شده باشد که میخواهید رفع مسدودی شود.
2. لینک مستقیم دانلود APK را آماده کنید
بعد از ساخت خروجی، باید یک لینک مستقیم از فایل APK داشته باشید. گوگل برای بررسی اپ باید بتواند فایل را مستقیماً دانلود کند.
در اپ ادیتور، بعد از دریافت خروجی، لینک دانلود فایل APK نمایش داده میشود. این لینک را کپی کنید و در فرم گوگل قرار دهید.
لینک دانلود باید مستقیم و قابل دسترسی باشد. یعنی گوگل بدون ورود، ثبتنام، رمز عبور یا محدودیت خاص بتواند فایل APK را دانلود کند.
3. فرم گوگل را با VPN باز کنید
برای ارسال درخواست، ابتدا VPN یا ابزار تغییر IP خود را فعال کنید و سپس وارد لینک زیر شوید:
https://support.google.com/googleplay/android-developer/contact/protectappeals
اگر بدون VPN وارد لینک شوید، ممکن است فرم برای شما باز نشود یا با خطای دسترسی مواجه شوید.
4. اطلاعات اپ را وارد کنید
در فرم گوگل، اطلاعات اپلیکیشن را دقیق و کامل وارد کنید. معمولاً لازم است مواردی مانند نام اپ، Package Name و توضیح مشکل را ثبت کنید.
در بخش توضیحات میتوانید بنویسید که اپ شما به اشتباه توسط Google Play Protect مسدود شده و درخواست بررسی مجدد دارید.
نمونه متن پیشنهادی برای توضیحات:
Hello Google Play Protect Team,
My Android application has been incorrectly flagged or blocked by Google Play Protect.
I believe this is a false positive. Please review the APK file and remove the warning or block if no harmful behavior is found.
Thank you.
5. لینک APK را در فرم وارد کنید
در بخشی که گوگل لینک فایل APK را درخواست میکند، لینک مستقیم دانلود APK را وارد کنید.
اگر گوگل لینک دانلود اپ شما را نپذیرفت، میتوانید یک اپ ساده و کمحجم ایجاد کنید، آن را با همان Keystore موردنظر خروجی بگیرید و لینک APK آن اپ ساده را برای گوگل ارسال کنید.
هدف اصلی این است که گوگل یک فایل APK امضاشده با همان Keystore را بررسی کند.
اگر فایل اصلی اپ حجم زیادی دارد یا لینک آن توسط گوگل پذیرفته نمیشود، یک اپ ساده و کمحجم بسازید، آن را با همان Keystore خروجی بگیرید و لینک مستقیم APK آن را در فرم گوگل قرار دهید.
6. فرم را ارسال کنید و منتظر پاسخ بمانید
بعد از ارسال فرم، باید ایمیل تأیید دریافت درخواست را از گوگل دریافت کنید. این ایمیل نشان میدهد که درخواست شما با موفقیت ثبت شده است.
معمولاً بررسی گوگل ممکن است حدود یک تا سه هفته زمان ببرد. پس از تأیید، اپ یا Keystore موردنظر بهصورت خودکار از حالت مسدودی خارج میشود.
بعد از ارسال فرم، نتیجه بررسی معمولاً فوری نیست. ممکن است رفع مسدودی حدود یک تا سه هفته زمان ببرد.
نکات مهم درباره رفع مسدودی Keystore
- اگر یک Keystore توسط گوگل بررسی و رفع مسدودی شود، میتوانید از همان Keystore برای اپهای دیگر نیز استفاده کنید.
- معمولاً نیازی نیست برای هر اپ جدید دوباره درخواست رفع مسدودی ارسال کنید، اگر با همان Keystore رفع مسدود شده خروجی بگیرید.
- برای ارسال به گوگل، APK باید با همان کلیدی امضا شده باشد که میخواهید رفع مسدودی شود.
- اطلاعات فرم را دقیق وارد کنید تا درخواست شما رد نشود یا با تأخیر بررسی نشود.
- بعد از رفع مسدودی، بهتر است برای خروجیهای بعدی نیز از همان کلید استفاده کنید.
از یک Keystore رفع مسدود شده میتوانید برای اپهای مختلف استفاده کنید و معمولاً نیازی به رفع مسدودی مجدد برای همان کلید نیست.
توصیههای مهم برای نگهداری Keystore
برای جلوگیری از مشکلات آینده، این نکات را رعایت کنید:
- فایل Keystore را در چند محل امن ذخیره کنید.
- رمز Keystore و رمز Alias را فراموش نکنید.
- اطلاعات کلید را در اختیار افراد غیرمطمئن قرار ندهید.
- برای اپهایی که منتشر میشوند، از کلیدهای موقت یا آزمایشی استفاده نکنید.
- مشخص کنید هر اپ با کدام Keystore ساخته شده است.
- قبل از دریافت خروجی نهایی، حتماً کلید انتخابشده را بررسی کنید.
اگر Keystore یا رمزهای آن را گم کنید، ممکن است دیگر نتوانید نسخه جدید اپ منتشرشده را با همان هویت قبلی منتشر کنید.
جمعبندی
Keystore امضای دیجیتال اپلیکیشن اندروید است و برای ساخت خروجی، انتشار و بهروزرسانی اپ ضروری است.
در اپ ادیتور، هنگام دریافت خروجی اندروید، بخش مدیریت کلید در اختیار شما قرار دارد. از این بخش میتوانید کلیدهای ساختهشده را مشاهده کنید، کلید جدید بسازید یا در صورت داشتن فایل Keystore و رمزهای آن، کلید آماده خود را آپلود کنید.
اگر اپ شما توسط Google Play Protect مسدود شد، میتوانید از طریق فرم رسمی گوگل درخواست بررسی و رفع مسدودی ارسال کنید. برای این کار باید با VPN فرم گوگل را باز کنید و یک لینک مستقیم از فایل APK امضاشده با همان Keystore در فرم ثبت کنید.
با نگهداری صحیح Keystore، استفاده از اطلاعات دقیق در فرم ساخت کلید و ارسال صحیح اپ برای بررسی گوگل، میتوانید احتمال مسدود شدن اپ را کاهش دهید و در صورت بروز مشکل، فرایند رفع مسدودی را انجام دهید.